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Prefácio 


Go tem sido fundamental no meu dia a dia escrevendo programas concor- 
rentes e plataformas (systems programming). É uma linguagem que favorece 
a criação de programas paralelos, leves, rápidos, simples de entender, de dis- 
tribuir (um simples binário compilado estaticamente) e de manter. 

Honestamente, porém, minhas primeiras impressões gerais sobre a lin- 
guagem não foram das melhores. A ausência de funcionalidades encontradas 
em outras linguagens mais sofisticadas me incomodava. Algumas bem po- 
lêmicas e controversas, como a de tipos genéricos e o tratamento de erros 
simples sem exceções. Não é incomum ter que escrever uma ou outra linha 
de código a mais em Go do que seria necessário em outra linguagem. Não é 
uma linguagem otimizada para programas curtos, mas sim para programas 
escaláveis. 

No início, o modo com que Go lida com concorrência e paralelismo foi o 
que despertou meu interesse na linguagem. Channels e goroutines são primiti- 
vas extremamente poderosas que continuam influenciando bastante a forma 
com que escrevo programas concorrentes, inclusive em outras linguagens. E 
eu tenho certeza de que vão influenciar a forma com que você escreve pro- 
gramas também. 

O resto não parecia ter nada de especial quando comparado com outras 
linguagens. Mas, com o tempo, fui aprendendo a apreciar a simplicidade de 
Go. Demorou um pouco até me cair a ficha de que a ausência de funcionali- 
dades que trariam complexidade foi (e continua sendo) uma decisão explícita 
de seus principais mantenedores. Isso faz com que Go seja uma linguagem 
relativamente fácil de aprender e geralmente existe apenas uma (ou poucas) 
forma(s) clara(s) de se resolver os problemas e escrever código em Go, a mai- 
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oria delas usando apenas o que já está disponível na biblioteca padrão. 

Quando me dá vontade de reclamar de que Go não tem essa ou aquela 
funcionalidade, lembro-me o quão simples é ler e entender programas escri- 
tos em Go. Lembro-me também de quanta discussão desnecessária se evita 
no dia a dia com outros programadores sobre como código deveria ser es- 
crito. Uma vez que se entende e aceita a mentalidade por trás da linguagem, 
times conseguem focar em escrever código que resolve problemas de verdade 
de forma simples de manter, em vez de gastar tempo discutindo preferências 
pessoais e de estilo de código. 

Go, na minha opinião, representa um ótimo balanço entre pragmatismo 
e funcionalidades. É uma escolha perfeita para programas que precisam so- 
breviver por muito tempo, na mão de muitas pessoas e times diferentes. 

Já tive o prazer de trabalhar diretamente com o Caio, que é um excelente 
programador e faz realmente um bom trabalho em apresentar a linguagem. 

Bom proveito e feliz programação! 

Fabio Kung 
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CAPÍTULO 1 


Introdução 


Desenvolver um software nunca foi uma tarefa fácil. Escrever um programa, 
por menor que ele seja, exige altas doses de concentração, paciência e atenção 
aos detalhes. Por vezes os problemas parecem não ter solução. E nada disso 
parece ter mudado muito com o passar do tempo: novas linguagens de pro- 
gramação e novas ferramentas são criadas todos os dias por programadores 
ao redor do mundo, enquanto o número de desafios não diminui. 

Ao contrário, numa época em que processadores com múltiplos núcleos 
(multi-core processors) estão presentes até mesmo em dispositivos móveis, 
programadores e administradores de sistemas sofrem para tentar usar ao má- 
ximo os recursos da máquina sem que haja impacto para seus usuários — ta- 
refa que se torna mais difícil conforme o número de usuários cresce. 

Não existe nenhuma linguagem de programação capaz de resolver todos 
estes problemas de forma fácil. No entanto, a linguagem Go surgiu num am- 
biente onde tais problemas são ainda mais extremos: o Google. 
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Apesar de bastante inspirada na linguagem C, Go possui características 
de mais alto nível, como abstrações para algumas estruturas de dados, coleta 
de lixo (garbage collection) e duck typing, além de trazer uma abordagem mo- 
derna e elegante para a criação de aplicações concorrentes. Go também inclui 
uma extensa biblioteca padrão com ferramentas para comunicação em redes, 
servidores HTTP, expressões regulares, leitura e escrita de arquivos e muito 
mais. 

O objetivo deste livro é apresentar ao leitor os recursos da linguagem Go e 
importantes partes da biblioteca padrão, sempre trazendo exemplos relevan- 
tes que demonstram o uso de cada recurso. 

Resolver os problemas citados anteriormente é um desafio enorme, mas 
Go veio para tornar esta tarefa um pouco mais prazerosa. 


1.1 POR QUE Go? 


Go nasceu como um projeto interno no Google, iniciado em 2007 por Rob 
Pike, Ken Thompson e Robert Griesemer, e posteriormente lançado como 
um projeto de código aberto em novembro de 2009. Pike e Thompson já 
haviam trabalhado juntos no Bell Labs, o berço do Unix e do Plan 9 — o sistema 
operacional que deu origem às ferramentas de compilação usadas como base 
do desenvolvimento da linguagem Go. 

No artigo (em inglês) “Go at Google: Language Design in the Service of 
Software Engineering” (http://talks.golang.org/2012/splash.article) , Rob Pike 
atribui os longos períodos de compilação e a dificuldade em escalar o desen- 
volvimento de grandes aplicações como sendo os principais motivadores para 
a criação da nova linguagem. Segundo ele, a maior parte do problema é a 
forma com que as linguagens C e C++ tratam o gerenciamento de dependên- 
cias entre os diversos arquivos-fonte. 

Dentro deste cenário, Go foi concebida com o objetivo de tornar o desen- 
volvimento de servidores no Google uma tarefa mais produtiva e eficiente. 

Para evitar os problemas de compilação, Go implementa um controle ri- 
goroso e inteligente de dependências, baseado na definição e uso de packages 
(pacotes). 


Com uma sintaxe bastante limpa, se comparada com outras linguagens 


Casa do Código Capítulo 1. Introdução 


inspiradas em C - como C++ e Java —, Go permite a escrita de programas 
concisos e legíveis, além de facilitar bastante a escrita de ferramentas que in- 
teragem com o código-fonte. Bons exemplos de tais ferramentas são go fmt 
(formata o código de acordo com o guia de estilo da linguagem) e go fix 
(reescreve partes do código que usa APIs depreciadas para que usem as novas 
APIs introduzidas em versões mais recentes). 

Go possui tipagem forte e estática, porém introduz uma forma curta de 
declaração de variáveis baseada em inferência de tipos, evitando redundân- 
cia e produzindo código muito mais sucinto do que linguagens estaticamente 
tipadas tradicionais. Além disso, Go traz uma implementação de duck typing 
(se faz “quack” como um pato e anda como um pato, então provavelmente é 
um pato) baseada em interfaces, permitindo a criação de tipos bastante flexi- 
veis. 

Alguns tipos de coleção de dados como slices (listas de tamanho diná- 
mico) e maps (dicionários de dados associativos) são nativos à linguagem, 
que também fornece um conjunto de funções embutidas para a manipulação 
destes tipos; arrays (listas de tamanho fixo) também estão disponíveis para 
casos em que um nível maior de controle é necessário. 

Go suporta o uso de ponteiros (referências a endereços de memória), o 
que torna ainda mais fácil a criação de poderosos tipos customizados. Entre- 
tanto, aritmética sobre ponteiros não é suportada. Apesar de toda a flexibi- 
lidade, através do uso de um coletor de lixo (ou garbage collector), Go reduz 
drasticamente a complexidade no gerenciamento de memória das aplicações, 
tornando-as mais robustas e evitando vazamentos descuidados. 

Go também fornece recursos que permitem a escrita de programas total- 
mente procedurais, orientados a objetos (através da definição de novos tipos e 
de funções que operam sobre tais tipos) ou funcionais — funções são membros 
de primeira classe em Go, que também suporta a criação de closures (funções 
que herdam o contexto de onde elas foram definidas). 

A abordagem de Go para concorrência é um dos maiores diferenciais da 
linguagem. Inspirada no famoso paper de C. A. R. Hoare Communicating Se- 
quential Processes [2], Go implementa goroutines — processos extremamente 
leves que se comunicam através de channels, evitando o uso de memória com- 
partilhada e dispensando o uso de travas, semáforos e outras técnicas de sin- 
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cronização de processos. 
Com todos estes recursos disponíveis, chegou a hora de ver como Go fun- 
ciona na prática. 


1.2 INSTALAÇÃO 


O primeiro passo para começar a escrever programas em Go é instalar a lin- 
guagem e suas ferramentas. Os pacotes de distribuição estão disponíveis no 
site http://golang.org/dl/. No momento da escrita deste livro, a versão está- 
vel disponível é a 1.3. Faça o download do pacote referente ao seu sistema 
operacional. A seguir você encontrará as instruções específicas para cada pla- 
taforma. 


Linux 
Abra um terminal, vá para o diretório onde você salvou o arquivo da 


distribuição (no caso do Linux, o nome do arquivo será parecido com 
go1.3.linux-amd64.tar.gz) e execute o comando a seguir: 


sudo tar -C /usr/local -xzf goi.3.linux-amd64.tar.gz 


As ferramentas da linguagem Go agora estarão disponíveis no diretório 
/usr/local/go. Adicione o diretório /usr/local/go/bin à variável de 
ambiente PATH para ter acesso às ferramentas, independente do diretório 
onde você estiver no sistema. Você pode fazer isso adicionando a seguinte 
linha ao seu arquivo SHOME/ .profile: 


export PATH=$PATH: /usr/local/go/bin 


Para verificar se a instalação está correta, execute o seguinte comando no 
terminal: 


$ go version 
Este comando deverá produzir uma saída similar à seguinte: 


go version goi.3 linux/amd64 
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Mac OS 


No Mac OS há duas formas de instalação. A mais simples é idêntica à no 
Linux, sendo a única diferença o nome do arquivo de distribuição: 


sudo tar -C /usr/local -xzf goi.3.darwin-amd64-0sx10.8.tar.gz 


A outra opção é baixar o instalador automático 
gol.3.darwin-amd64-0sx10.8.pkg. Execute-o e siga as instruções. 

As duas formas disponibilizam as ferramentas instaladas no diretório 
/usr/local/go. Após a instalação, assim como no Linux, adicione o di- 
retório /usr/local/go/bin à variável de ambiente PATH no seu arquivo 
SHOME/.profile: 


export PATH=$PATH:/usr/local/go/bin 


E verifique se a instalação está correta, executando o seguinte comando 
no terminal: 


$ go version 


Este comando deverá produzir uma saída similar ao que segue: 


go version gol.3 darwin/amd64 


Windows 


No Windows, assim como no Mac OS, há duas formas de instalação. A 
forma recomendada é a utilização do instalador automático. Faça o download 
do arquivo gol.3.windows-amd64.msi, execute-o e siga as instruções 
passo a passo. Após a instalação, as variáveis de ambiente serão automatica- 
mente configuradas e você poderá seguir para as instruções de pós-instalação. 

A forma alternativa é fazer o download do pacote 
gol.3.windows-amd64.zip e descompactá-lo no diretório C:NGo. 
Em seguida, adicione o diretório C:\Go\bin à variável de ambiente PATH. 

Para ter certeza de que a instalação foi bem-sucedida, execute o seguinte 
comando no prompt: 


C:\>go version 
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Este comando deverá produzir uma saída similar à seguinte: 


go version gol.3 windows/amd64 


Instalando Go em um diretório não-padrão 


Todas as instruções apresentadas anteriormente partem do princípio de 
que a instalação foi feita no diretório padrão - /usr/local/go no Linux 
e Mac OS, e C:\Go no Windows. Caso você não tenha esta opção ou pre- 
fira realizar a instalação em um diretório diferente, algumas configurações 
adicionais são necessárias. 

Para que tudo funcione como esperado, é preciso configurar a variável 
de ambiente GOROOT para referenciar o diretório escolhido para a instala- 
ção. Por exemplo, se a instalação foi feita no diretório SHOME/go no Linux, 
adicione a seguinte configuração ao seu SHOME/.profile: 


export GOROOT=$HOME/ go 
export PATH=$PATH: $GOR0OT/bin 


No Windows, uma configuração semelhante deve ser feita. 
Entretanto, para evitar problemas, é recomendável que o diretório padrão 
seja utilizado. 


Pós-instalação 


A partir deste momento, todos os exemplos de comandos serão escritos 
utilizando a notação Unix, assumindo que você tem uma instalação funcional 
da linguagem Go e que o diretório GOROOT/bin foi adicionado à variável 
PATH (sendo que GOROOT deve ser o diretório no qual Go foi instalada). 

Para extrair o máximo das ferramentas disponíveis na instalação, preci- 
samos criar um diretório de trabalho (workspace) onde todos os programas 
devem residir. A estrutura do workspace inclui três subdiretórios: 


e src contém o código-fonte de todos os seus programas escritos em 
Go (organizados em pacotes), e também o código-fonte de pacotes de 
terceiros instalados em seu sistema; 


e pkg contém objetos referentes aos pacotes; 
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e bin contém arquivos executáveis gerados no seu sistema. 


Crie um workspace e adicione-o à variável de ambiente GOPATE: 
$ mkdir $HOME/go 


Para maior conveniência, configure a variável GOPATEH no seu ar- 
quivo SHOME/.profile (ou nas configurações avançadas do seu Win- 
dows conforme mencionado anteriormente), e adicione também o diretório 
GOPATH/bin à variável de ambiente PATH: 


export GOPATH=$HOME/go 
export PATH=$PATH: $GOPATH/bin 


1.3 O PRIMEIRO PROGRAMA EM GO 


Programas em Go podem ser escritos em qualquer editor de textos que tenha 
suporte à codificação UTF-8. Os arquivos-fontes devem necessariamente 
ser salvos nesta codificação, caso contrário o compilador não será capaz de 
processá-los. 

Agora podemos finalmente escrever nosso primeiro programa em Go. 
Crie um novo diretório chamado capl-ola dentro de SGOPATH/src. No 
diretório recém-criado, utilize seu editor de textos favorito e crie um novo 
arquivo chamado ola. go com o seguinte conteúdo e salve o arquivo: 


package main 
import "fmt" 


func main() 1 
fmt.Println("Olá, Go!") 
+ 


Para executar o programa, utilizaremos a ferramenta go. Vá para o dire- 
tório SGOPATH/src e execute o seguinte comando: 


$ go run capi-ola/ola.go 
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Após a execução do programa, o texto “Olá, Go!” deverá ser impresso no 
terminal. 

Arquivos-fonte contendo código Go devem seguir sempre a mesma es- 
trutura, dividida em três seções: primeiro, a declaração do pacote, seguida 
da declaração dos pacotes externos dos quais o arquivo-fonte depende, e por 
fim, o código referente ao programa ou pacote sendo escrito. 

Todo código Go deve obrigatoriamente existir dentro de um pacote (pac- 
kage), e todo programa em Go deve ter um pacote main contendo uma fun- 
ção main () que serve como ponto de partida do programa. 

No exemplo anterior, importamos o pacote fmt, que contém funções 
para a formatação de strings, eutilizamosa função Print ln para mostrar 
o texto “Olá, Go!” para o usuário. 

Repare que a função main () não recebe nenhum argumento e não re- 
torna nenhum valor. Diferente de linguagens como Java e C, argumentos pas- 
sados para um programa Go através da linha de comando não são automati- 
camente disponibilizados ao programa. Em vez disso, precisamos utilizar um 
pacote chamado os, que será apresentado posteriormente. 

Agora já temos um ambiente de desenvolvimento funcional, e acabamos 
de escrever o primeiro programa em Go. 

Nos capítulos 2 e 3, veremos alguns exemplos que apresentarão a sintaxe 
básica e alguns dos recursos da linguagem. Nos capítulos posteriores, entra- 
remos em detalhes sobre as funcionalidades mais importantes. 


CAPÍTULO 2 


Explorando a sintaxe básica 


Agora que você já tem um ambiente capaz de compilar e executar programas 
em Go, vamos fazer um pequeno passeio sobre as principais características da 
linguagem com alguns exemplos guiados. O objetivo dos exemplos a seguir 
é familiarizar o leitor com os elementos mais comuns da sintaxe, as princi- 
pais palavras reservadas e estruturas de controle, além de apresentar alguns 
idiomas comuns no desenvolvimento de aplicações em Go. 

Todos os exemplos de código deste livro estão disponíveis para consulta 
no endereço https://github.com/caiofilipini/casadocodigo-go. 

Os recursos apresentados nos exemplos serão explicados em maiores de- 
talhes nos próximos capítulos. 


2.1 ESTRUTURA DO CAPÍTULO 


Este capítulo é baseado em dois exemplos. 
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O primeiro é um simples conversor de medidas que apresentará o uso de 
alguns elementos básicos da linguagem, como as estruturas de controle if e 
for, o conceito de slices e tratamento básico de erros. Este exemplo pode ser 
encontrado na seção 2.4. 

O segundo, encontrado na seção 2.6, é uma implementação do algoritmo 
de ordenação quicksort, e introduz o uso de funções, recursividade e a função 
append (). 

Antes de apresentar os exemplos, porém, veremos o funcionamento bá- 
sico das expressões if eo que são arrays e slices. 


2.2 [F E EXPRESSÕES LÓGICAS 


Em Go, diferente de algumas linguagens, somente expressões de valor lógico 
verdadeiro ou falso podem ser utilizadas em conjunto com instruções if. 

Estas expressões devem necessariamente ser do tipo bool - cujos úni- 
cos valores possíveis são true e false - e podem ser variáveis ou mesmo 
funções ou métodos, desde que retornem um valor do tipo bool. 


2.3 ARRAYS E SLICES 


Go possui dois tipos padrões para listas de dados: arrays e slices. 

Um array é uma lista de tamanho fixo, similar a um array nas lingua- 
gens C ou Java. 

Já um slice é uma camada de abstração criada com base nos arrays 
e pode crescer indefinidamente, proporcionando uma flexibilidade muito 
maior. 

As diferenças entre eles serão discutidas em detalhes no capítulo 4. 


2.4 EXEMPLO 1: CONVERSOR DE MEDIDAS 


O primeiro exemplo é um simples conversor de medidas. Ele aceita como en- 
trada uma lista de valores com sua unidade de medida, e produz uma lista de 
valores convertidos. Por questões didáticas, o conversor trabalha apenas com 
dois tipos de conversões: de graus Celsius para Fahrenheit, e de quilômetros 
pra milhas. 
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package main 


import ( 
" fmt n 
"n os "n 
"strcony" 
) 


A primeira seção do programa não é muito diferente do que já vimos an- 
teriormente. Porém, como este exemplo é um pouco mais complexo, impor- 
tamos o pacote fmt, mas também precisamos dos pacotes os e strconv. 

O pacote os possui uma série de operações que lidam com o sistema 
operacional hospedeiro de forma independente, facilitando a escrita de apli- 
cações multiplataformas. No exemplo a seguir, utilizaremos este pacote para 
ter acesso aos argumentos passados ao nosso programa via linha de comando, 
e também para instruir o programa a interromper sua execução e retornar um 
código de erro adequado em casos excepcionais. 

Já o pacote strconv fornece uma grande variedade de funções para a 
conversão de strings para outros formatos e vice-versa. Os argumentos 
recebidos via linha de comando são sempre tratados como strings, por- 
tanto, para que o nosso conversor seja capaz de realizar operações matemá- 
ticas sobre os valores, utilizaremos o pacote strconv para convertê-los em 
números decimais. 

A seguir precisamos declarar a função main () que, conforme visto no 
capítulo anterior, não recebe argumentos e não retorna nenhum valor. O con- 
teúdo desta função será discutido passo a passo. 


func main() 1 
// 
+ 


Como em qualquer programa que depende da entrada de dados de usuá- 
rios, a primeira coisa que o conversor faz é garantir que os argumentos passa- 
dos via linha de comando estão em um formato minimamente são. Para isso, 
verificamos a quantidade de argumentos recebidos — presentes em os.Args 
— através do uso da função embutida len (). 
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os.Args contém uma lista (tecnicamente um slice) de todos os argumen- 
tos passados para o programa, sendo que por padrão o primeiro argumento 
sempre será o próprio nome do programa executado. Portanto, verificamos 
se os.Args possui pelo menos três argumentos — o nome do programa; pelo 
menos um valor a ser convertido; e a unidade referente aos valores — através 
da instrução de controle if. 

Caso a quantidade de argumentos fornecidos seja menor do que três, uti- 
lizamos a já conhecida função Print1n do pacote fmt para apresentar ao 
usuário uma mensagem de ajuda com o formato de entrada do programa, 
e logo depois utilizamos a função os.Exit () para abortar a execução do 
programa. Note que a função os.Exit () foi chamada com o valor 1 como 
argumento; o valor especificado é retornado como código de erro para o sis- 
tema operacional. Seguindo os padrões de programas Unix, qualquer valor 
diferente de 0 indica uma execução anormal. 


if len(os.Args) < 3 1 
fmt.Println("Uso: conversor <valores> <unidade>") 
os.Exit(1) 


Seguindo a execução quando três ou mais argumentos foram fornecidos, 
encontramos a declaração e atribuição de duas variáveis: unidadeOrigem 
e valoresOrigem. Em Go, quando uma variável é declarada e atribuída na 
mesma operação, não é preciso informar seu tipo - o compilador é inteligente 
o suficiente para adivinhá-lo baseado na operação de atribuição; ou seja, caso 
o valor 10 seja atribuído à variável x, o compilador sabe que o tipo de x é 
um número inteiro, ou int em Go. 

Atribuímos à unidadeOrigem o último argumento passado, de acordo 
com o formato esperado. Para isso, acessamos a última posição do slice 
os.Args. Slices são listas indexadas e de tamanho variável em Go, sendo 
que o primeiro elemento possui índice 0. Sendo assim, o índice do último 
elemento é sempre n - 1, sendo n o número total de elementos presentes 
no slice — no caso, len (os.Args)-1. 


unidadeOrigem := os.Args[len(os.Args)-1] 
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A variável valoresOrigem recebe uma sublista dos argumentos, des- 
cartando o primeiro (o nome do programa) e o último (a unidade já atribuída 
à unidadeOrigem). Em Go, este tipo de operação é trivial e conhecida como 
slicing (fatiar, separar) - daí vem o nome dado ao tipo de listas dinâmicas. 
Assim, fatiamos a lista completa de argumentos, obtendo somente os valores 
que devemos converter: os.Args[1 : len(os.Args)-1]. O índice 1 
refere-se ao segundo elemento, e len (os. Args) —1 ao último elemento, que 
é desconsiderado no slice retornado. 


valoresOrigem := os.Args[1 : len(os.Args)-1] 


Uma vez que identificamos a unidade-origem e os valores a serem conver- 
tidos, precisamos descobrir qual é a unidade-destino e, consequentemente, 
qual fórmula de conversão deverá ser usada. Conforme mencionado anteri- 
ormente, nosso programa só sabe converter graus Celsius para Fahrenheit e 
quilômetros para milhas. 

Declaramos a variável uni dadeDest ino como sendo do tipo string. 
Como seu conteúdo depende de uma verificação e, portanto, não podemos 
atribuir a ela um valor no momento da declaração, precisamos utilizar a 
palavra-chave var antes do nome da variável, e neste caso precisamos tam- 
bém informar seu tipo logo após o nome. Se você está acostumado com lin- 
guagens como C e Java, pode achar a ordem da declaração um pouco estra- 
nha - nestas linguagens, declara-se primeiro o tipo e depois o nome da variá- 
vel. Repare como em Go a leitura da declaração fica mais fluida: declare uma 
variável com nome unidadeDestino do tipo string. 


var unidadeDestino string 


Para atribuir o valor correto à unidadeDestino, verificamos o con- 
teúdo de unidadeOrigem: caso sejaa string "celsius", atribuímos 
"fahrenheit"; caso seja "quilometros", atribuímos "milhas"; caso 
seja qualquer outro valor desconhecido, informamos este fato ao usuário e in- 
terrompemos a execução do programa. Note que, desta vez, utilizamos a fun- 
ção fmt . Print f, que imprime na saída padrão uma string de acordo com 
o formato especificado, similar à função print f da linguagem C. Neste caso, 
especificamos o formato %s não é uma unidade conhecida!, onde 
%s será substituído pelo valor da variável unidadeDestino. 
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if unidadeOrigem == "celsius" { 
unidadeDestino = "fahrenheit" 
} else if unidadeOrigem == "quilometros" { 
unidadeDestino = "milhas" 
} else 1 
fmt.Printf("hks não é uma unidade conhecida!", 
unidadeDestino) 
os.Exit(1) 
} 


Agora que conhecemos a unidade-origem, os valores a serem conver- 
tidos e também a unidade-destino, vamos à conversão propriamente dita. 
Para converter todos os valores informados, precisamos percorrer o slice 
valoresOrigem, transformar cada valor em um número decimal, aplicar 
a fórmula sobre este número e imprimir o resultado. 

Go possui apenas uma estrutura de repetição, for, que pode ser usada 
de diferentes formas de acordo com o contexto; no nosso caso, utilizamos 
for em conjunto com o operador range para obter acesso a cada elemento 
do slice valoresOrigem. O operador range, quando aplicado a um slice, 
retorna dois valores para cada elemento: primeiro, o índice do elemento no 
slice, e depois, o elemento propriamente dito. Atribuímos o índice à variável 
i eo elemento à v. 


for i, v := range valoresOrigem { 


PR saga 


Em seguida, utilizamos a função ParseFloat () do pacote strconv 
para converter a string em um número de ponto flutuante. Esta função 
recebe dois argumentos — o valor a ser convertido e a precisão do valor retor- 
nado (32 ou 64 bits) — e retorna dois valores: o valor convertido e um erro de 
conversão (que é nil quando o valor é convertido com sucesso). Caso um 
erro aconteça, informamos ao usuário (novamente utilizando fmt.Printf 
para mostrar corretamente o valor - string, representado como %s no for- 
mato — e sua posição na lista de argumentos — int, representado como %d) 
e interrompemos a execução do programa. 
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valor0rigem, err := strconv.ParseFloat(v, 64) 
if err != nil { 
fmt.Printf( 
"0 valor %s na posição %d não é um número válido!Nn", 
ARE 
os.Exit(1) 


Com o valor correto em mãos, declaramos a variável valorDestino 
como sendo do tipo float 64, verificamos qual é a unidade-origem e, apli- 
cando a fórmula correspondente à unidade, atribuímos a ela o valor conver- 
tido. 


var valorDestino float64 


if unidadeOrigem == "celsius" { 
valorDestino = valor0rigem+*1.8 + 32 
+ else 1 


valorDestino = valor0rigem / 1.60934 


Por fim, utilizamos novamente a função fmt.Printf para apresentar 
o valor convertido e sua unidade ao usuário. Repare que utilizamos %.2f 
para informar à função que o valor é do tipo float e deve ser arredondado 
e formatado com duas casas decimais. 


fmt.Printf(").2f hs = K.2f Hs", 
valor0rigem, unidadeOrigem, valorDestino, unidadeDestino) 


A seguir, você encontra o código completo do conversor. Para executá-lo, 
crie um novo diretório chamado cap2-conversor em SGOPATH/src e, 
dentro dele, crie um arquivo chamado conversor. go com o conteúdo: 


package main 


import ( 
"fmt "n 
n" os n 
"strconv" 
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func main() { 
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if len(os.Args) < 31 
fmt.Println("Uso: conversor <valores> <unidade>") 
os.Exit(1) 

} 


unidadeO0rigem := os.Args[len(os.Args)-1] 
valores0rigem := os.Args[1 : len(os.Args)-1] 


var unidadeDestino string 


if unidadeOrigem == "celsius" { 
unidadeDestino = "fahrenheit" 

> else if unidadeDrigem == "quilometros" { 
unidadeDestino = "milhas" 

} else { 
fmt.Printf("%s não é uma unidade conhecida!", 

unidadeDestino) 

os.Exit(1) 

E: 

for i, v := range valoresOrigem { 
valor0rigem, err := strconv.ParseFloat(v, 64) 
if err != nil 1 


fmt .Printf( 
"O valor %s na posição jd " + 
"não é um número válido!hn", 
Ts. d) 
os.Exit(1) 


var valorDestino float64 


if unidadeOrigem == "celsius" { 
valorDestino = valorOrigem+1.8 + 32 
+ else { 


valorDestino = valorOrigem / 1.60934 
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fmt.Printf(").2f hs = K.2f hsm", 
valor0rigem, unidadeOrigem, 
valorDestino, unidadeDestino) 


Um exemplo da execução do programa: 


$ go run cap2-conversor/conversor.go 32 27.4 -3 O celsius 
32.00 celsius = 89.60 fahrenheit 

27.40 celsius = 81.32 fahrenheit 

-3.00 celsius = 26.60 fahrenheit 

0.00 celsius = 32.00 fahrenheit 


Algumas das técnicas apresentadas neste exemplo também serão utiliza- 
das nos próximos e, portanto, não serão explicadas novamente. 


2.5 CRIANDO FUNÇÕES BÁSICAS 


Antes de implementar o próximo exemplo, vejamos algumas formas básicas 
para a definição de funções: 


func imprimirDados (nome string, idade int) { 
fmt.Printf("ks tem Yd anos.", nome, idade) 


func main() { 
imprimirDados ("Fernando", 29) 


A função imprimirDados () recebe dois argumentos, uma string 
representando o nome, e um int representando a idade, e imprime os dois 
argumentos através do uso da função fmt . Print f (). Assim como a função 
especial main (), imprimirDados () não retorna nenhum valor. 


func soma(n, m int) int { 
return n + m 
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func main() { 
s := soma(3, 5) 
fmt.Println("A soma é", s) 


Esta outra função simples, denominada soma (), recebe dois argumen- 
tos- ne m- do tipo int e retorna a soma dos dois, também do tipo int. 
Note que, como os dois argumentos são do mesmo tipo, podemos simplifi- 
car sua declaração separando os nomes dos argumentos com uma vírgula e 
especificando seu tipo uma única vez. 

Agora que conhecemos o básico sobre funções, vamos à implementação 
do próximo exemplo. 


2.6 EXEMPLO 2: QUICKSORT E FUNÇÕES 


O segundo exemplo é uma implementação simples do famoso algoritmo de 
ordenação quicksort. A ideia básica deste algoritmo é: 


1) eleger um elemento da lista como pivô e removê-lo da lista; 


2) particionar a lista em duas listas distintas: uma contendo elementos me- 
nores que o pivô, e outra contendo elementos maiores; 


3) ordenar as duas listas recursivamente; 


4) retornar a combinação da lista ordenada de elementos menores, o próprio 
pivô, e a lista ordenada de elementos maiores. 


Como a recursividade é naturalmente parte deste algoritmo, nossa im- 
plementação será baseada em uma função recursiva. Este exemplo é mais 
complexo do que o anterior, porém muito mais expressivo, e demonstra como 
algumas construções da linguagem ajudam a escrever programas bastante su- 
cintos. 
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Implementando o quicksort 


Nosso programa limita-se a ordenar números inteiros. Os números são 
recebidos como argumentos via linha de comando de forma muito similar ao 
exemplo do conversor de unidades; a diferença é que desta vez utilizamos a 
função strconv.Atoi () para convertê-los em números inteiros em vez de 
decimais. 

Repare também que a declaração do slice numeros, que armazenará os 
números inteiros, é bastante diferente da forma que foi utilizada no conver- 
sor: aqui utilizamos a função nativa make () para criar e inicializar um slice 
do tipo [] int - um slice de números inteiros — especificando também seu 
tamanho inicial como sendo o mesmo da lista recebida como argumento, o 
que é sempre uma boa ideia quando sabemos de antemão qual será o tamanho 
final do slice. 

Depois de converter a entrada do programa para uma lista de números in- 
teiros, chamamos uma função denominada quicksort (), passando como 
argumento a lista de números a ser ordenada e imprimindo a lista resultante. 


func main() { 
entrada := os.Args[1:] 
numeros := make([]int, len(entrada)) 


for i, n := range entrada ( 
numero, err := strconv.Atoi(n) 
if err != nil { 
fmt.Printf("As não é um número válido!Nn", n) 
os.Exit(1) 
1 


numeros[i] = numero 


fmt .Println (quicksort (numeros) ) 


A função quicksort () é responsável pela implementação do algo- 
ritmo. Ela recebe como argumento um slice de números inteiros e retorna 
um slice ordenado, como podemos ver na assinatura a seguir: 
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func quicksort (numeros [Jint) [Jint { 
UA soa 
$ 


O primeiro passo é verificar se a lista de entrada está vazia ou contém 
apenas um número e, em caso positivo, retornar a própria lista. Esta condi- 
ção é extremamente importante em funções recursivas; é a chamada condição 
de parada, que previne que a função seja executada eternamente ou até que 
aconteça uma sobrecarga na pilha de execução (stack overflow). 


if len(numeros) <= 1 { 
return numeros 


O próximo passo é criar uma cópia do slice original para evitar que ele seja 
modificado. Utilizamos a função embutida copy () para copiar o conteúdo 
do slice numeros para o n, que é criado com o mesmo tamanho do slice 
original: 


n := make([]int, len(numeros)) 
copy (n, numeros) 


A partir deste ponto, manipularemos somente o novo slice n. Veremos a 
função copy () em maiores detalhes no capítulo 4.2. 

Em seguida, fazemos a escolha do pivô. Neste caso, utilizamos uma das 
técnicas mais simples e escolhemos o elemento que se encontra mais ou me- 
nos no meio da lista. Armazenamos o índice — que será importante em breve 
— e o próprio pivô: 


indicePivo := len(n) / 2 
pivo := n[indicePivo] 


Com o pivô em mãos, precisamos removê-lo da lista original. Faremos 
isso através do uso da função nativa append (). Ela adiciona um elemento 
ao final de um slice, e sua forma geral é: 


novoSlice := append(slice, elemento) 
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Isso pode parecer um tanto estranho quando queremos de fato remover 
um elemento do slice. Entretanto, combinando o uso append () com opera- 
ções de slice, temos uma construção bastante poderosa e idiomática em Go: 


n = append(n[:indicePivo], n[indicePivo+1:]...) 


Primeiro, fatiamos o slice n do primeiro elemento até o pivô - 
n[:indicePivo] - e utilizamos este novo slice como base para a ope- 
ração de append(); depois, fatiamos novamente n, partindo do ele- 
mento imediatamente posterior ao pivô até o último elemento disponível — 
n[indicePivo+1:] - e utilizamos este slice como valor a ser adicionado 
ao slice-base. É muito importante notar o uso das reticências ao final do se- 
gundo argumento: estamos informando que todos os elementos do segundo 
slice devem ser adicionados ao slice-base. 

O resultado desta operação é uma lista que contém todos os elementos 
anteriores ao pivô, e todos os elementos posteriores a ele, exceto o próprio 
pivô. Missão cumprida! 

O próximo passo do algoritmo é particionar o slice de números em dois 
novos slices — um contendo todos os elementos menores ou iguais ao pivô, e 
outro contendo somente os elementos maiores. Esta tarefa é delegada a uma 
outra função chamada particionar (), que será explicada em breve. Note 
que tiramos proveito do fato de que a função particionar () retorna dois 
valores distintos — dois slices: 


menores, maiores := particionar(n, pivo) 


O último passo é ordenar estes dois slices recursivamente e combinar 
os resultados com o pivô, e é exatamente o que a última linha da função 
quicksort () faz - novamente através do uso da função append(): 


return append( 
append(quicksort (menores), pivo), 
quicksort (maiores)...) 


Primeiro, chamamos quicksort () recursivamente para ordenar o slice 
menores; depois adicionamos o pivo ao resultado desta ordenação; em 
seguida, fazemos outra chamada recursiva a quicksort () para ordenar 
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o slice maiores; e por fim, combinamos as duas listas ordenadas com 
append () de maneira similar à apresentada anteriormente e retornamos. 
A seguir a listagem completa da função quicksort (): 


func quicksort (numeros [Jint) [Jint 1 
if len(numeros) <= 11 
return numeros 


n := make([]int, len(numeros)) 
copy(n, numeros) 


indicePivo := len(n) / 2 
pivo := n[indicePivo] 
n = append(n[:indicePivo], n[indicePivo+1:1]...) 


menores, maiores := particionar(n, pivo) 


return append( 
append(quicksort (menores), pivo), 
quicksort (maiores)...) 


Para finalizar, vamos analisar a assinatura da função particionar (): 


func particionar( 
numeros [Jint, 
pivo int) (menores []int, maiores [Jint) 1 


RP sã 


Esta função recebe dois argumentos - um slice numeros []int eum 
pivo int - e retorna dois valores - um slice menores []int contendo 
todos os números menores ou iguais ao pivo e um slice maiores []int 
contendo os números maiores que o pivo. A implementação completa é 
bastante trivial e também faz uso da função append () apresentada anteri- 
ormente. 
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func particionar( 
numeros [Jint, 
pivo int) (menores [Jint,maiores [Jint) 1 


for _, n := range numeros { 
if n <= pivo { 
menores = append(menores, n) 
} else { 
maiores = append(maiores, n) 


return menores, maiores 


Um detalhe importante e novo que aparece na função particionar () é 
a presença do símbolo _, conhecido como identificador vazio (ou blank iden- 
tifier). Como já vimos anteriormente, o operador range, quando utilizado 
para iterar sobre um slice, retorna sempre dois valores: o índice do elemento e 
o próprio elemento. Muitas vezes não precisamos dos dois valores, porém em 
Go uma variável declarada e não utilizada causa um erro de compilação. Para 
resolver este problema, utiliza-se o identificador vazio para ignorar um valor 
que não será usado. Isto se aplica a qualquer operação que retorne múltiplos 
valores e não se restringe apenas ao operador range. 

A seguir você encontra a listagem completa da nossa implementação de 
quicksort. Crie um diretório chamado cap2-quicksort logo abaixo do 
diretório SGOPATH/src, e dentro dele crie o arquivo quicksort .go com 
o conteúdo a seguir: 


package main 


import ( 
"fmt " 
n os "n 
"strconv" 
) 


func main() { 
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entrada := os.Args[1:] 
numeros := make([]int, len(entrada)) 


for i, n := range entrada { 
numero, err := strconv.Atoi(n) 
JE érr l= nil É 


Casa do Código 


fmt .Printf ("%s não é um número válido!\n", n) 


os.Exit(1) 
} 
numeros [i] = numero 


} 


fmt .Println (quicksort (numeros)) 


func quicksort (numeros []int) [Jint { 
if len(numeros) <= 1 { 
return numeros 


n := make([]int, len(numeros)) 
copy(n, numeros) 


indicePivo := len(n) / 2 
pivo := n[indicePivo] 


n = append(n[:indicePivo], n[indicePivo+1:]... 


menores, maiores := particionar(n, pivo) 


return append( 
append (quicksort (menores), pivo), 
quicksort (maiores)...) 


func particionar( 
numeros []int, 


pivo int) (menores []int, maiores []int) { 


for _, n := range numeros { 


24 


Casa do Código Capítulo 2. Explorando a sintaxe básica 


if n <= pivo 1 

menores = append (menores, n) 
} else 1 

maiores = append(maiores, n) 


} 


return menores, maiores 


Para ver este exemplo em execução, utilize o comando a seguir: 


$ go run cap2-quicksort/quicksort.go 10 30 41 53 78 12 19 22 
[10 12 19 22 30 41 53 78] 


Neste capítulo, aprendemos a utilizar o básico das estruturas de controle 
ife for. Também vimos o que são arrays e slices, e aprendemos a 
criar nossas próprias funções. 

Os tipos de coleção disponiveis em Go, incluindo arrays e slices, se- 
rão discutidos em detalhes no capítulo 4. As funções e todos os seus recursos 
serão apresentados no capítulo 6. 
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CAPÍTULO 3 


Indo além: mais exemplos 


No capítulo anterior, aprendemos alguns elementos básicos da sintaxe e algu- 
mas das construções mais fundamentais em Go. Neste capítulo avançaremos 
um pouco mais através de exemplos que utilizam maps (dicionários de da- 
dos) e tipos customizados. 


3.1 EXEMPLO 3: MAPAS E ESTATÍSTICAS 


Um map - também conhecido como array associativo ou dicionário — é uma 
coleção de pares chave/valor sem ordem definida, em que cada chave é única 
e armazena um único valor. 

O exemplo a seguir utiliza um map para contar a frequência de pa- 
lavras com as mesmas iniciais. Recebemos a lista de palavras via linha 
de comando, assim como já fizemos nos exemplos anteriores. Armaze- 
namos a lista em um slice denominado palavras, chamamos a função 
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colherEstatisticas() utilizando o slice palavras como argumento, 
armazenamos as estatísticas numa variável e, por fim, chamamos a função 
imprimir () para imprimi-las. 


package main 


import ( 
"fmt " 
" os " 
"strings" 
) 


func main() { 
palavras := os.Args[1:] 


estatisticas := colherEstatisticas(palavras) 


imprimir (estatisticas) 


Nenhuma novidade até aqui, exceto pelo fato de que importamos o pacote 
strings. Este pacote contém uma gama de funções para manipulação de 
strings. 

A função colherEstatisticas () possui a seguinte assinatura: 


func colherEstatisticas(palavras []string) map[stringlint 


Repare que o tipo de retorno é map [string] int: um map com chaves 
do tipo string e valores do tipo int, ideal para armazenar as estatísticas 
que desejamos. Para cada item armazenado, a chave é a letra inicial da palavra 
e o valor é a quantidade de palavras com esta inicial. 

Dentro da função declaramos o map que irá armazenar as estatísticas e 
damos a ele o nome estatisticas. Para inicializar um map utilizamos a 
função make (), similar à inicialização de slices: 


estatisticas := make (map[stringlint) 


Em seguida, para cada palavra, extraímos sua letra inicial- palavra [0] 
- e, utilizando a função ToUpper () do pacote strings, convertemos a 
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inicial para maiúscula e a armazenamos na variável inicial. Desta forma, 
garantimos que não haja distinção de palavras escritas em caixa alta ou baixa. 

Com a inicial em mãos, procuramos no mapa estatisticas uma en- 
trada cuja chave seja esta inicial: 


contador, encontrado := estatisticas [inicial] 


Para acessar um valor em um map, utilizamos uma notação similar ao 
acesso de valores em um slice, porém utilizamos a chave do valor entre os 
colchetes — no nosso caso, a string representando a letra inicial. Esta ope- 
ração retorna dois valores: o valor armazenado sob aquela chave e um bool 
indicando se a chave existe ou não no map. Atribuímos estes dois valores 
às variáveis contador e encontrado, respectivamente. Caso já exista um 
contador paraa inicial (encontrado possuio valor true), incrementa- 
mos a contagem ( contador + 1) e a atualizamos no mapa; caso contrário, 
é a primeira ocorrência de uma palavra com esta inicial e, portanto, armaze- 
namos a contagem inicial 1. 

Após iterar sobre todas as palavras, nosso mapa estatisticas possuia 
contagem completa, e então ele é usado como valor de retorno para a função 


colherEstatisticas(). 


if encontrado { 
estatisticas [inicial] = contador + 1 
} else { 
estatisticas [inicial] 


ll 
m. 


return estatisticas 


A função imprimir () recebe o mapa contendo as estatísticas e sim- 
plesmente itera sobre todas as entradas, imprimindo as estatísticas para cada 
inicial: 


func imprimir(estatisticas map[string]int) { 
fmt.Println("Contagem de palavras iniciadas em cada letra:") 


for inicial, contador := range estatisticas { 
fmt .Printf("%s = Ydin", inicial, contador) 
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Veja como iterar sobre todas as entradas de um map é uma tarefa trivial 
quando utilizamos o operador range: como cada entrada no mapa é, por 
definição, um par chave, valor, o retorno de range se encaixa perfeitamente. 
É importante ressaltar que, em Go, a ordem de iteração sobre maps é alea- 
tória e, portanto, não se deve confiar nela. No capítulo 4 estudaremos maps 
mais a fundo e veremos como garantir a ordem desejada nestes casos. 

A seguir você encontra a listagem completa do programa. Crie o arquivo 
cap3-maps/maps . go com o seguinte conteúdo: 


package main 


import ( 
" fmt " 
n os " 
"strings" 
) 


func main() { 
palavras := os.Args[1:] 


estatisticas := colherEstatisticas(palavras) 


imprimir (estatisticas) 


func colherEstatisticas(palavras []string) map[stringlint 1 
estatisticas := make(map[stringlint) 


for _, palavra := range palavras { 
inicial := strings.ToUpper(string(palavra[0])) 
contador, encontrado := estatisticas [inicial] 
if encontrado { 
estatisticas [inicial] = contador + 1 
} else { 
estatisticas [inicial] 


Il 
= 


} 
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return estatisticas 


func imprimir(estatisticas map[stringlint) 1 
fmt.Println("Contagem de palavras iniciadas em cada letra:") 


for inicial, contador := range estatisticas { 
fmt.Printf("hs = Ydin", inicial, contador) 
} 


E um exemplo da entrada e saída: 


$ go run cap3-maps/maps.go \ 

Lorem ipsum dolor sit amet leo eu velit ante sagittis dolor N 
turpis dis 

Contagem de palavras iniciadas em cada letra: 


<Smerunonmo 
po 
e sa se o o TR | 


3.2 EXEMPLO 4: PILHAS E TIPOS CUSTOMIZADOS 


Definir tipos customizados traz inúmeros benefícios à legibilidade e robus- 
tez de um programa. Go possui algumas funcionalidades que facilitam esta 
tarefa, e veremos mais sobre este assunto no capítulo 5. 

O exemplo a seguir apresenta uma implementação simples de uma pilha 
de objetos através de um tipo customizado. 

Desta vez não receberemos argumentos via linha de comando, simples- 
mente empilhamos e desempilhamos alguns valores e interagimos com a pilha 
chamando alguns outros métodos utilitários. 
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Para facilitar o entendimento da interface da pilha, veremos cada passo 
da função main () que interage com ela, e posteriormente, veremos a imple- 
mentação de cada método. 

Inicialmente, criamos uma instância da pilha e atribuímos o objeto retor- 
nado à variável pilha. Em seguida, imprimimos o resultado da chamada 
de métodos: pilha.Tamanho() e pilha.Vazia(), que retornam 0 e 
true, respectivamente. 


pilha := Pilha{} 


fmt.Println("Pilha criada com tamanho ", pilha.Tamanho()) 
fmt.Printin("Vazia? ", pilha.Vazia()) 


Se você já programou em qualquer outra linguagem com suporte a ori- 
entação a objetos, não encontrou nenhuma grande novidade até aqui. En- 
tretanto, repare que os nomes de todos os métodos que chamamos se ini- 
ciam com uma letra maiúscula. Go possui uma forma muito simples de con- 
trole de acesso: todo identificador iniciado com uma letra maiúscula den- 
tro de um pacote é automaticamente exportado e visível fora do pacote. Na 
prática, já utilizamos esta funcionalidade quando chamamos funções como 
fmt .Println(), por exemplo. 

Uma pilha vazia não é muito útil. Vamos agora empilhar quatro objetos e 
verificar o Tamanho () da pilha e se ela continua Vazia (): 


pilha.Empilhar("Go") 
pilha. Empilhar (2009) 
pilha.Empilhar(3.14) 
pilha.Empilhar ("Fim") 


fmt.Printin("Tamanho após empilhar 4 valores: ", 
pilha.Tamanho ()) 
fmt.Println("Vazia? ", pilha.Vazia()) 


Veja que somos capazes de empilhar valores de tipos completamente di- 
ferentes: duas strings, um int eum float 64. Sem nenhuma surpresa, 
as duas últimas linhas do trecho anterior imprimirão 4 e false, respecti- 
vamente. E agora que temos uma pilha cheia, que tal desempilhar todos os 
objetos? 
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Como vimos anteriormente, for é a única estrutura de repetição dis- 
ponível em Go. Mas isto não significa que ela seja limitada. A seguir uti- 
lizamos uma forma diferente da iteração com for, similar à construção 
while em outras linguagens. Enquanto a pilha não estiver vazia ( for 
!pilha.Vazia()),o bloco será executado. Dentro do bloco, desempilha- 
mos um valor e o atribuímos à variável v, cujo valor é mostrado ao usuário, 
junto com os resultados de pilha.Tamanho() e pilha.Vazia() após 
cada operação de remoção. Note que o método pilha.Desempilhar () 
retorna dois valores. O segundo valor indica um erro que, neste momento, 
optamos por ignorar, atribuindo-o ao identificador vazio _. 


for !pilha.Vazia() 1 
v, — := pilha.Desempilhar() 
fmt.Println("Desempilhando ", v) 
fmt.Println("Tamanho: ", pilha.Tamanho()) 
fmt.Println("Vazia? ", pilha.Vazia()) 


Ao final da iteração, a pilha está vazia novamente. Poderíamos nos certifi- 
car deste fato chamando a função pilha.Vazia(). Porém, decidimos cha- 
mar o método pilha.Desempilhar () mais uma vez. Agora, no entanto, 
ignoramos o primeiro valor retornado e atribuímos o segundo à variável err. 
Por fim, se um erro foi retornado, ele é apresentado ao usuário. 


—, err := pilha.Desempilhar() 
if err != nil { 

fmt .Println (err) 
F 


Agora vamos à definição do tipo Pilha e seus métodos. 

Diferente de outras linguagens com suporte à programação orientada a 
objetos, Go não possui o conceito de classes. Em vez disso, definimos estru- 
turas de dados em forma de structs, construções semelhantes às structs 
da linguagem C, e um conjunto de funções - métodos, neste caso — que ma- 
nipulam estes dados. A seguir temos a definição do novo tipo Pilha: 


type Pilha struct { 
valores [J]interface() 


} 
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O novo tipo possui apenas um membro: um slice denominado valores, 
que armazena objetos do tipo interface(). Este tipo é conhecido como 
interface vazia e descreve uma interface sem nenhum método. Qualquer tipo 
em Go implementa pelo menos zero métodos, portanto satisfaz a interface 
vazia. Na prática, isto faz com que a nossa implementação de pilha seja capaz 
de armazenar objetos de qualquer tipo Go válido, conforme pudemos ver na 
implementação da função main (). 

Oslice valores foi intencionalmente declarado com a inicial minúscula, 
garantindo que ele não seja acessível em outro pacote. 

Tendo definido o tipo Pilha, podemos começar a definir seus métodos. 
Começaremos com o simples método Tamanho (): 


func (pilha Pilha) Tamanho() int { 
return len(pilha.valores) 


k 


A definição de um método é muito semelhante à definição de uma função, 
como já vimos anteriormente. A diferença marcante é que métodos definem 
um objeto receptor, que neste caso foi chamado de pilha eé do tipo Pilha, 
que deve ser especificado entre parênteses antes do nome do método. Assim, 
o método Tamanho () acessa o slice pilha.valores e retorna seu tama- 
nho utilizando a função len (). 

É importante observar que, como Go não possui o conceito de classes, 
seus métodos também não possuem um receptor implícito - conhecido como 
self ou this em outras linguagens. Isto facilita muito a implementação 
do runtime da linguagem e aumenta a clareza do código, já que dentro da 
definição do método só existe uma forma de acessar seu receptor. 


O método pilha.Vazia() é trivial e simplesmente verifica se o tama- 
nho atual da pilha é igual a zero: 


func (pilha Pilha) Vazia() bool 1 
return pilha.Tamanho() == 
+ 


Os dois métodos apresentados até aqui são imutáveis — não possuem ne- 
nhum efeito colateral — e, portanto, bastante simples. 
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No caso dos métodos Empilhar() e Desempilhar (), desejamos al- 
terar a pilha na qual tais métodos foram chamados. Em Go, argumentos de 
funções e métodos são sempre passados por cópia (com a exceção de slices, 
maps e channels, que são conhecidos como reference types, como veremos 
nos próximos capítulos). Por isso, quando precisamos alterar qualquer argu- 
mento — incluindo receptores de métodos — devemos declará-los como pon- 
teiros. Vejamos a definição do método Empilhar (): 


func (pilha *Pilha) Empilhar (valor interface()) 1 
pilha.valores = append(pilha.valores, valor) 


} 


Repare que o tipo do receptor foi definido como +Pilha, e indica que 
a variável pilha é um ponteiro para um objeto do tipo Pilha. Para em- 
pilhar um novo objeto, adicionamo-lo ao slice pilha.valores através do 
uso da função append () ealteramos o valor atual de pilha. valores para 
guardar o novo slice que contém o objeto adicionado. 

De forma similar, o método Desempilhar () também define o receptor 
como sendo um ponteiro. Como vimos na definição da função main (), este 
método possui dois valores de retorno: o objeto desempilhado e um valor do 
tipo error que é retornado quando a pilha está vazia. Para isso, utilizamos o 
método pilha.Vazia() e, em caso de retorno positivo, criamos um novo 
erro através da função errors. New () e retornamos nil no lugar do objeto 
desempilhado, junto com o erro recém-criado. 

Caso a pilha não esteja vazia, atribuímos o último objeto empilhado à 
variável valor. Em seguida, atualizamos o slice pilha. valores com uma 
fatia do slice atual, incluindo todos os objetos empilhados com a exceção do 
último — que acabou de ser desempilhado. Finalmente, retornamos o objeto 
removido e nil no lugar do erro, indicando que o objeto foi desempilhado 
com sucesso. 


func (pilha *Pilha) Desempilhar() (interface(), error) 1 
if pilha.Vazia() 1 
return nil, errors.New("Pilha vazia!") 


} 
valor := pilha.valores[pilha.Tamanho()-1] 
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pilha.valores = pilha.valores[:pilha.Tamanho()-1] 
return valor, nil 


Confira a listagem completa da implementação da pilha. Utilize o con- 
teúdo a seguir para criar o arquivo cap3-pilha/pilha.go: 


package main 


import ( 
"errors" 
" fmt " 

) 


func main() 1 
pilha := Pilha{} 
fmt.Println("Pilha criada com tamanho ", pilha.Tamanho()) 
fmt.Println("Vazia? ", pilha.Vazia()) 


pilha.Empilhar("Go") 

pilha.Empilhar (2009) 

pilha.Empilhar(3.14) 

pilha.Empilhar("Fim") 

fmt.Println("Tamanho após empilhar 4 valores: ", 
pilha.Tamanho()) 

fmt.Println("Vazia? ", pilha.Vazia()) 


for !pilha.Vazia() { 
v, — := pilha.Desempilhar() 
fmt.Println("Desempilhando ", v) 
fmt.Println("Tamanho: ", pilha.Tamanho()) 
fmt.Println("Vazia? ", pilha.Vazia()) 


—, err := pilha.Desempilhar() 
if err != nil 1 
fmt.Println("Erro: ", err) 
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type Pilha struct { 
valores [J]interface() 


func (pilha Pilha) Tamanho() int { 
return len(pilha.valores) 


} 


func (pilha Pilha) Vazia() bool { 
return pilha.Tamanho() == 
} 


func (pilha *Pilha) Empilhar (valor interface{}) { 
pilha.valores = append(pilha.valores, valor) 


} 


func (pilha *Pilha) Desempilhar() (interface{}, error) { 
if pilha.Vazia() { 
return nil, errors.New("Pilha vazia!") 
} 
valor := pilha.valores [pilha.Tamanho()-1] 
pilha.valores = pilha.valores[:pilha.Tamanho()-1] 
return valor, nil 


Um exemplo deste programa em execução: 


$ go run cap3-pilha/pilha.go 
Pilha criada com tamanho O 
Vazia? true 

Tamanho após empilhar 4 valores: 4 
Vazia? false 
Desempilhando Fim 

Tamanho: 3 

Vazia? false 
Desempilhando 3.14 
Tamanho: 2 

Vazia? false 
Desempilhando 2009 
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Tamanho: 1 

Vazia? false 
Desempilhando Go 
Tamanho: O 

Vazia? true 

Erro: Pilha vazia! 


Neste capítulo, melhoramos nosso conhecimento a respeito dos recursos 
básicos da linguagem Go. Vimos a utilização básica de mapas para classifi- 
car valores sob chaves, e aprendemos a definir tipos customizados para criar 
abstrações mais complexas. 

Mapas serão discutidos em detalhes no capítulo 4.3, e aprenderemos ainda 
mais sobre outras formas de criar tipos customizados no capítulo 5. 
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CAPÍTULO 4 


Coleções: arrays, slices e maps 


Nos capítulos anteriores, vimos como coleções são essenciais para a solução 
de vários problemas. Agora veremos as coleções disponíveis em Go em mai- 
ores detalhes. 


4.1 ARRAYS 


Arrays em Go são coleções indexadas de valores do mesmo tipo e de tamanho 
fixo e invariável. O primeiro elemento do array possui índice 0, e o último 
elemento é sempre len (array) - 1. 


Para declarar um array, podemos utilizar uma das seguintes formas: 


var a [3]int 
numeros := [5]int(1, 2, 3, 4, 5} 
primos. = E. ss lintio, 3,5; Ty. 1 136 
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nomes := [2]string{} 
fmt.Println(a, numeros, primos, nomes) 

O resultado da última linha seria o seguinte: 
[0 0 0] [1 2 3 4 5] [2 3 57 11 13] [] 


O array a foi declarado como [3] int, ou uma lista de 3 números intei- 
ros. O tamanho de um array deve sempre ser especificado na declaração e faz 
parte do tipo do array - [3] inte [5] int são considerados tipos diferentes, 
ainda que ambos carreguem valores do mesmo tipo. 

Apesar de não termos inserido nenhum valor em a, obtivemos [0 O 
0] quando imprimimos seu conteúdo. Quando um array é declarado, seus 
elementos ganham automaticamente um valor inicial conhecido como zero 
value em Go. Este valor inicial varia de acordo com o tipo de dados definido 
para o array, da seguinte forma: 


e false para valores do tipo bool; 

e 0 para ints; 

e 0.0 para floats; 

e "" (ou string vazia) para strings; 


e nil para ponteiros, funções, interfaces, slices, maps e channels. 


Algumas vezes sabemos de antemão quais serão os valores contidos num 
array, e podemos declará-los utilizando a forma literal, como em numeros 
:= [5]int{1, 2, 3, 4, 5). Nestes casos, para facilitar a vida do pro- 
gramador, pode-se substituir o tamanho do array na declaração pelo operador 
ellipsis (reticências), instruindo o compilador a calcular o tamanho do array 
com base na quantidade de elementos declarados, como fizemos em primos 
= [...Jinti2, 3, 5, 7, 11, 135. 

Por fim, declaramos nomes := [2]string() - um array de duas 
strings - utilizando a forma literal, porém sem nenhum valor declarado 
entre as chaves, fazendo com que os elementos sejam inicializados com "". 
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Esta declaração é idêntica à primeira forma utilizada (para declarar o array 
a) e poderia ser escrita também da seguinte forma: 


var nomes [2]string 


O tamanho de um array pode ser obtido através do uso da função len (). 
Por exemplo, a execução do código a seguir nos daria 3 5 6 2 como resul- 
tado: 


fmt.Println(len(a), len(numeros), len(primos), len(nomes)) 


Podemos também criar arrays cujos valores são também arrays, ou arrays 
multidimensionais, de forma similar a arrays simples: 


var multiA [2] [2] int 
multiA [0] [0], multiA [0] [1] 
multiA[1] [0], multiA[1][1] = 7, -2 


i 
s 
o 


multiB := [2] [2]int((2, 13), 1-1, 6) 


fmt.Println("Multi A:", multiA) 
fmt.Println("Multi B:", multiB) 


Repare que, na declaração literal do array mult iB, não precisamos espe- 
cificar o tipo dos arrays internos. 

Imprimindo os valores de multiA e multiB teríamos o seguinte resul- 
tado: 


Multi A: [[3 5] [7 -2]] 
Multi B: [[2 13] [-1 6]] 


Os arrays têm sua importância e seu papel, mas não são muito flexíveis, 
especialmente nos casos em que precisamos aumentar seu tamanho dinami- 
camente. É possível fazer isso com arrays, mas exige um grande trabalho ma- 
nual de verificação de limites, alocação de novos arrays e cópia de conteúdo. 

Em quase todos os casos, em Go é mais comum utilizar slices. A própria 
biblioteca padrão da linguagem utiliza slices em vez de arrays como parâme- 
tros e tipos de retorno em sua API pública. A seguir veremos os benefícios e 
facilidades de se trabalhar com eles. 
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4.2 SLICES 


Um slice é uma poderosa abstração criada em cima de arrays que introduz 
uma série de facilidades. Diferente de um array, no entanto, um slice possui 
tamanho variável e pode crescer indefinidamente. 

Na prática, a utilização de slices é muito similar ao que acabamos de 
aprender sobre arrays. Para declarar um slice, podemos utilizar quase a 
mesma sintaxe da declaração de arrays, incluindo a forma literal, com a dife- 
rença de que não especificamos o tamanho do slice: 


var a [Jint 
primos := []Jint(2, 3, 5, 7, 11, 13) 
nomes := []string{} 


fmt.Printin(a, primos, nomes) 


Teríamos a seguinte saída impressa: 


E. [2:36 T aria A 


Como não especificamos o tamanho dos slices a e nomes nem adicio- 
namos nenhum valor a eles durante a declaração, ambos estão vazios após a 
inicialização. 

Arrays e slices em Go possuem duas propriedades importantes: tamanho 
e capacidade - len () e cap (), respectivamente, são as funções utilizadas 
para inspecionar estas propriedades. 

Um slice pode ser criado também através da função make (), que in- 
ternamente aloca um array e retorna uma referência para o slice criado. Ela 
possui a seguinte assinatura: 


func make([]T, len, cap) []T 


T representa o tipo dos elementos do slice, len o tamanho inicial do 
array alocado e cap o tamanho total da área de memória reservada para o 
crescimento do slice. Por conveniência, pode-se omitir o último argumento, 
e neste caso Go assume por padrão o mesmo valor do tamanho. Vejamos 
alguns exemplos: 
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b := make([Jint, 10) 
fmt.Println(b, len(b), cap(b)) 


c := make([]int, 10, 20) 
fmt.Printin(c, len(c), cap(c)) 


Esse código imprimiria: 


[0000000000] 1010 
[0000000000] 10 20 


Note que os 10 primeiros elementos — 10 foi o tamanho especificado — 
dos dois slices foram inicializados com 0, o zero value para ints, conforme 
vimos anteriormente. 

Uma grande vantagem de utilizar slices — de fato, qualquer tipo criado 
através da função make () — em vez de arrays é que, quando usados como 
argumentos ou no retorno de funções, são passados por referência e não por 
cópia. Isto torna estas chamadas muito mais eficientes, pois o tamanho da 
referência será sempre o mesmo, independente do tamanho do slice. 


Iteradores 


Já iteramos sobre slices nos exemplos anteriores, e agora veremos todas 
as diferentes formas de iteração disponíveis em Go. 

Sabemos que a única estrutura de repetição em Go é o for. Em sua 
forma mais básica, podemos especificar uma condição lógica e o bloco será 
executado enquanto a condição for verdadeira — similar à construção while 
em outras linguagens. Por exemplo: 


a, b := 0, 10 
forea g p£ 

a += 1 
fmt .Println(a) 


Podemos ler esse código como enquanto a for menor que b, incremente 
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o valor de a. Seu resultado seria a impressão do valor 10, valor de a após 
a execução do bloco for. 

Também podemos utilizar o for com uma cláusula de inicialização, uma 
condição lógica e uma cláusula de incremento — a construção tradicional da 
linguagem C: 


for i := 0; i< 10; it+ 1 


PA tus 


É importante notar que, como a variável i não existia antes do for, seu 
escopo é limitado ao bloco; se tentarmos acessar seu valor após a execução do 
bloco, teremos um erro de compilação informando que i não foi definida. 
Para resolver esses casos, precisamos declarar a variável antes do for: 


var i int 


for i= 0; i<10; it 


VP eua 


fmt.Println(i) 


Desta forma, i continua existindo após a execução do bloco for,e o 
programa imprimiria o valor 10. 

Qualquer elemento da cláusula for pode ser omitido, mas o ponto e 
vírgula é obrigatório - a não ser que o único elemento presente seja a condição 
lógica, como já vimos no primeiro exemplo de uso do for. Desconsiderando 
o escopo da variável de controle, todas as formas a seguir são equivalentes: 


i := 0 
for i < 10 £ 

i+= 1 
} 


for J :='0; )$ 10; J7 | 
Eia 
+ 
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var k int 
for k = 0; k< 10; 1 
k += 1 


for ; 1 < 10; 1+ { 
RE sin 
} 


A forma mais comum de iterar sobre slices, porém, é utilizando o opera- 
dor range, como já vimos nos capitulos anteriores. A sintaxe geral é: 


for indice, valor := range slice { 
EF nah 
i 


O operador range retorna o índice de cada elemento, começando em 0, 
e uma cópia de cada valor presente no slice. Quando precisamos modificar os 
valores em um slice, ou estamos interessados somente nos índices, podemos 
simplesmente omitir o segundo valor na atribuição e acessar cada elemento 
através de seu índice: 


numeros := []int{1, 2, 3,4, 5} 


for i := range numeros { 
numeros [i] += 2 


fmt.Println (numeros) 


O código anterior itera sobre um slice chamado numeros, multiplicando 
cada valor por 2. Após a iteração, imprimimos o conteúdo de numeros e 
obtemos [2 4 6 8 10] como resultado. 

Ao contrário, quando não precisamos dos índices dos valores, podemos 
ignorá-los atribuindo-os ao identificador vazio: 
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for _, elemento := range slice { 


D+ unia 


A última forma de utilização do for é a forma conhecida como loop in- 
finito, que em Go é simplesmente uma cláusula for sem nenhuma condição 
— Go assume true como valor padrão para a condição: 


for 1 
// loop infinito 


Para sair da execução de um loop infinito, podemos utilizar o comando 
break. 

A seguir, temos um exemplo que inicia um loop infinito, gera números 
aleatórios e sai do loop somente quando o número gerado for divisível por 
42, ou seja, o resto da divisão do valor por 42 éo - i$42 == 0. Crie um 
novo arquivo chamado cap4-loop-infinito/loop infinito.gocom 
o seguinte conteúdo: 


package main 


import ( 
"fmt" 
"math/rand" 
"time" 

) 


func main() 1 
rand.Seed(time.Now().UnixNano()) 
n :=0 


for { 
n++ 


i := rand. Intn(4200) 
fmt.Println(i) 


if i%42 == 0 { 
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break 


fmt.Printf ("Saída após %d iterações.n", n) 


Quando geramos números aleatórios, é sempre importante configurar o 
valor conhecido como seed (semente) do gerador. No exemplo anterior, uti- 
lizamos o timestamp atual no formato padrão do Unix — o número de nano 
segundos desde 1º de janeiro de 1970 — para garantir que, a cada execução do 
programa, o gerador de números aleatórios produza números diferentes da 
vez anterior. 

Um exemplo da saída do programa: 


$ go run cap4-loop-infinito/loop infinito.go 
1458 

3816 

2413 

1179 

594 

1562 

93 

2911 

1131 

3008 

2235 

3910 

2928 

1470 

Saída após 14 iterações. 


Por padrão, break sai do loop mais próximo ao ponto em que o comando 
foi executado. Há casos nos quais temos loops for aninhados e desejamos 
quebrar o loop externo em vez do interno. Para resolver este problema, Go 
também dá suporte a blocos for nomeados. Vejamos um exemplo: 


var i int 
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externo: 
for { 
for i = 0; i < 10; i++ { 
if i=5{ 
break externo 
} 
} 
} 


fmt.Println(i) 


Este recurso também é importante quando temos, por exemplo, um 
bloco switch dentro de um bloco for. Como o comando break 
também é usado para sair do switch, precisamos especificar o nome 
dado ao bloco for se quisermos sair do loop. Vamos criar um programa 
para demonstrar o uso de laços nomeados. Crie um arquivo chamado 
cap4-loop-nomeado/loop_nomeado.go definindo um pacote main, 
importando o pacote fmt, e adicione o seguinte conteúdo à função main (): 


var à int 
loop: 
for i = 0; i < 10; i++ 


fmt .Printf ("for i = Ydln", i) 


switch i { 


case 2, 3: 
fmt .Printf ("Quebrando switch, i == %d.\n", i) 
break 
case 5: 
fmt.Printin("Quebrando loop, i == 5.") 
break loop 
} 


fmt.Println("Fim.") 


A saída do programa seria a seguinte: 
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$ go run cap4-lo0p-nomeado/lo0p. nomeado. go 


for i = 0 

for i=1 

for i=2 

Quebrando switch, i == 2. 
for i =3 

Quebrando switch, i == 3. 
for i=4 

for i = 5 

Quebrando loop, i == 5. 
Fim. 

Fatiando slices 


Fatiar (do inglês to slice) é o nome dado a operações que extraem partes 
de um slice ou de um array. 
Para fatiar um slice ou array, utilizamos a seguinte forma: 


novoSlice := slice[inicio : fim] 


Sendo que 0 <= inicio <= fim <= len (slice). Qualquer com- 
binação de índices inicial e final que não atenda a esta regra resulta em um 
erro de compilacão (slice bounds out of range, ou limites do slice fora de al- 
cance). 

Por questões práticas, podemos omitir o índice inicial e/ou final. Se o 
índice inicial for omitido, 0 é assumido como padrão; de maneira similar, 
len (slice) -1 é assumido como valor padrão para o índice final: 


Fib v= ESTA, dy 2 3% 5,08, 185 
fmt.Println(fib) 
fmt.Println(fib[:3]) 
fmt.Println(fib[2:]) 
fmt.Println(fib[:]) 


Esse código imprimiria: 
[13235819] 
[112] 


[2 3 5 8 13] 
[112358 13] 
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Como citado anteriormente neste capítulo, um slice é uma abstração cri- 
ada com base nos arrays. Entender a relação entre eles é essencial para traba- 
lhar efetivamente com slices. 

Sabemos que, quando um slice é criado, um array é alocado internamente. 
Quando fatiamos este slice e o atribuímos a uma nova variável, temos um 
novo slice que compartilha o mesmo array interno do original. Isto quer 
dizer que, quando um elemento comum aos dois slices é modificado, esta 
modificação é refletida no outro. Vejamos um exemplo: 


original := [Jint(1, 2, 3, 4, 5) 
fmt.Println("Original:", original) 


novo := original[1:3] 
fmt.Println("Novo:", novo) 


original[2] = 13 


fmt.Println("Original pós modificação:", original) 
fmt.Printin("Novo pós modificação:", novo) 


A saída deste programa seria a seguinte: 


Original: [123465] 

Novo: [2 3] 

Original pós modificação: [1 2 134 5] 
Novo pós modificação: [2 13] 


Veja que, ao alterarmos o valor de original [2] para 13,0 conteúdo dos 
dois slices foi modificado. Isto é verdade para qualquer slice criado fatiando 
um outro slice, independente da quantidade de indireções criadas. Veja mais 
um exemplo: 


:= [string("Paulo", "almoça", "em", "casa", "diariamente.") 
:= a[:len(a)-1] 
:= b[:len(b)-1] 
:= c[:len(c)-1] 
:= d[:len(d)-1] 


eo cpm 
Ii 


e[0] = "Tiago" 
fmt .Printf("%v\nýv\n%v\n%v\n%ýv\n", a, b, c, d, e) 
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E o resultado impresso seria: 


[Tiago almoça em casa diariamente.] 
[Tiago almoça em casa] 

[Tiago almoça em] 

[Tiago almoça] 

[Tiago] 


Todas as operações apresentadas anteriormente também são válidas em 
um array, e é importante mencionar que fatiar um array sempre resulta em 
um slice, nunca em outro array. 


Inserindo valores 


Todas as operações realizadas sobre slices são baseadas na função 
append (). Já vimos alguns exemplos de como usá-la. Sua assinatura é: 


func append(slice []Tipo, elementos ...Tipo) []Tipo 


Para inserir um novo valor ao final de um slice, utilizamos append () 
em sua forma mais básica: 


s := make([Jint, 0) 
s = append(s, 23) 


fmt.Println(s) 


Executando este código, veríamos o valor [23] impresso. 

Para inserir um novo valor no começo de um slice, precisamos inicial- 
mente criar um novo slice contendo o valor que desejamos inserir, e depois 
adicionar todos os elementos do slice inicial ao recém-criado. Parece compli- 
cado, mas na prática é bastante simples: 


s Dint(23, 24, 25) 
n := [Jint(22) 
s = append(n, s...) 


fmt.Println(s) 
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Uma outra opção mais sucinta é criar o novo slice utilizando a forma li- 
teral na própria chamada à função append (): 


s := []int{23, 24, 25) 
s = append([]int{22}, s...) 


fmt.Println(s) 


As duas formas são semanticamente equivalentes e imprimiriam [22 23 
24 25]. Repare que utilizamos novamente o operador ellipsis (reticências) 
para expandir o conteúdo do slice, garantindo que todos os valores sejam 
passados de forma individual à função append (). 

Também é possível inserir um ou mais valores em qualquer posição no 
meio de um slice. Para isso, precisamos fatiar o slice até a posição onde dese- 
jamos inserir os novos valores - s [:3] - e utilizar esta fatia do slice original 
como primeiro argumento na chamada à append (). O segundo argumento 
deve ser, por sua vez, o resultado de uma segunda operação de append (), 
onde inserimos os valores restantes do slice original - s[3:]... — ao slice 
que contém os novos valores - append (v, s[3:]...).... Repare nova- 
mente o uso do operador ellipsis, aparecendo duas vezes neste exemplo: 


[Hintf1lt, 12, 13, 16, 17; 18} 
[] int{14, 15) 
= append(s[:3], append(v, s[3:]...)...) 


s 
v 
s 
fmt .Println(s) 


Esse código imprimiria [11 12 13 14 15 16 17 18]. 


Removendo valores 


Para remover valores do começo de um slice não precisamos da função 
append () . Basta fatiar o slice ignorando os índices dos elementos que dese- 
jamos remover, e atribuir o novo slice à mesma variável. Por exemplo, pode- 
mos remover o primeiro valor de um slice da seguinte forma: 


s := []int{20, 30, 40, 50, 60} 
s = s[1:] 
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fmt.Println(s) 


Assim, esse código imprimiria o slice [30 40 50 60]. 
De maneira análoga, para remover valores do final de um slice, fatiamos 
este slice ignorando os índices dos elementos finais: 


s := []int(20, 30, 40, 50, 60} 
s = s[:3] 


fmt.Println(s) 


E agora o slice s teria o conteúdo [20 30 40]. 

Por fim, para remover valores do meio de um slice, precisamos recorrer 
novamente à função append (), utilizando duas fatias do slice original como 
argumentos — a primeira incluindo elementos do início até o índice desejado, 
e a segunda começando do próximo elemento que nos interessa. Por exem- 
plo, dado um slice s := [Jint(10, 20, 30, 40, 50, 60), podemos 
remover os valores 30 e 40 da forma a seguir: 


s := []int{10, 20, 30, 40, 50, 60} 
s = append(s[:2], s[4:]...) 


fmt.Println(s) 


Ao executar esse código, teríamos o slice [10 20 50 60] impresso 
conforme o esperado. 


Copiando slices 


Até agora, todas as vezes em que manipulamos slices, utilizamos a função 
append () para modificar o slice original. No entanto, muitas vezes preci- 
samos manter o estado do slice original intacto e manipular uma cópia dele. 
Para isso, Go também possui uma função embutida chamada copy (), com 
a seguinte assinatura: 


func copy (destino, origem []Tipo) int 
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Para criar uma cópia de um slice, chamamos a função copy () da se- 
guinte forma: 


numeros := []int{1, 2, 3, 4, 5} 
dobros := make([]int, len(numeros)) 


copy (dobros, numeros) 


for i := range dobros { 
dobros[i] += 2 


fmt.Println(numeros) 
fmt.Println(dobros) 


Imprimindo o conteúdo dos dois slices, teríamos [1 2 3 4 5]e [2 4 
6 8 10] como resultado, provando que o slice original não sofreu nenhuma 
alteração. 


4.3 MAPS 


Um map, ou mapa, é uma coleção de pares chave-valor sem nenhuma or- 
dem definida. É a implementação em Go de uma estrutura de dados também 
conhecida como hashtable, dicionário de dados ou array associativo, entre 
outros nomes. 

Qualquer tipo que suporte os operadores de igualdade (i.e. == e !=) pode 
ser usado como chave em um mapa. No entanto, as chaves em um mesmo 
mapa devem necessariamente ser do mesmo tipo. É importante mencionar 
também que as chaves são únicas - se armazenarmos dois valores distintos 
sob uma mesma chave, o primeiro valor será sobrescrito pelo segundo. 

Os valores em um mapa também devem sempre ser do mesmo tipo, em- 
bora a interface vazia interface ) seja um tipo válido neste caso. Isto pos- 
sibilita armazenar virtualmente qualquer valor sob uma chave, porém requer 
uma asserção de tipo (type assertion) quando os valores são recuperados. 

Podemos declarar mapas utilizando a forma literal ou a função make (), 
de maneira muito semelhante à declaração de slices. Por exemplo, para de- 
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clarar um mapa vazio com chaves do tipo int e valores do tipo string,as 
duas opções a seguir são equivalentes: 


vazioi := map[int]string() 
vazio2 := make(map[int]string) 


A quantidade de valores armazenados em um mapa é flexível e pode cres- 
cer indefinidamente durante a execução de um programa, sendo que pode- 
mos especificar sua capacidade inicial quando sabemos de antemão quantos 
valores precisaremos armazenar. Isso pode ser importante quando sabemos 
que o mapa irá armazenar muitos valores, tornando o uso de memória mais 
eficiente e evitando problemas de performance. É recomendável especificá-la 
sempre que possível, e podemos fazê-lo simplesmente passando um segundo 
argumento à função make (): 


mapaGrande := make (map [int]string, 4096) 


A qualquer momento podemos inspecionar a quantidade de elementos 
que um mapa possui através da função len (). Por exemplo: 


capitais := map[stringlstringí 
"GO": "Goiânia", 
"PB": "João Pessoa", 


"PR": "Curitiba") 
fmt.Println(len(capitais)) 
O código imprimiria o valor 3. 


Populando mapas 


Podemos popular um mapa utilizando literais no momento da declaração 
e/ou atribuindo valores individualmente após a declaração: 


capitais := map[stringl]string( 
"GO": "Goiânia", 
"PB": "João Pessoa", 


"PR": "Curitiba") 
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capitais ["RN"] = "Natal" 
capitais ["AM"] = "Manaus" 
capitais ["SE"] = "Aracaju" 


fmt.Println(capitais) 


populacao := make(map[stringlint, 6) 
populacao ["G0O"] = 6434052 

populacao ["PB"] = 3914418 

populacao ["PR"] = 10997462 
populacao ["RN"] = 3373960 

populacao ["AM"] = 3807923 

populacao ["SE"] = 2228489 


fmt.Printin(populacao) 


O resultado da execução desse código seria o seguinte: 


map[G0:Goiânia PB:João Pessoa PR:Curitiba RN:Natal 
AM:Manaus SE: Aracaju] 

map [GO: 6434052 PB:3914418 PR: 10997462 RN:3373960 
AM:3807923 SE:2228489] 


Para tornar o exemplo anterior um pouco mais real, vamos implementá- 
lo utilizando um novo tipo, chamado Estado. Crie um arquivo chamado 
cap4-estados/estados.go e adicione a definição do tipo Estado com 
a seguinte estrutura: 


type Estado struct { 
nome string 
populacao int 
capital string 


Agora, na função main (), podemos popular um mapa de estados desta 
forma: 


estados := make (map [string]Estado, 6) 
estados ["G0"] = Estado("Goiás", 6434052, "Goiânia") 
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estados ["PB"] 
estados ["PR"] 
estados ["RN"] 
estados ["AM"] 
estados ["SE"] 


Estado("Paraíba", 3914418, "João Pessoa") 
Estado("Paraná", 10997462, "Curitiba") 
Estado("Rio Grande do Norte", 3373960, "Natal") 
Estado("Amazonas", 3807923, "Manaus") 
Estado("Sergipe", 2228489, "Aracaju") 


fmt.Println(estados) 


Esse código imprimiria o seguinte conteúdo (as quebras de linha e alguns 
espaços em branco foram deliberadamente adicionados para facilitar a visu- 
alização): 
$ go run cap4-estados/estados.go 
map [GO: (Goiás 6434052 Goiânia) 

PB:(Paraíba 3914418 João Pessoas 
PR: (Paraná 10997462 Curitiba) 
RN:(Rio Grande do Norte 3373960 Natal) 


AM: (Amazonas 3807923 Manaus) 
SE: (Sergipe 2228489 Aracaju}] 


Lookup: recuperando valores 


A operação de recuperação de um valor em um mapa é conhecida como 
lookup e é muito similar à recuperação de valores de um índice específico em 
um slice — basta especificar a chave desejada entre colchetes: 


sergipe := estados ["SE"] 
fmt.Println(sergipe) 


Desta forma, a variável sergipe receberia o Estado presente no mapa 
eovalor (Sergipe 2228489 Aracaju) seria impresso. 

E o que aconteceria se tentássemos acessar o valor de um estado que não 
está presente no mapa? 


fmt.Println(estados["SP"]) 


O valor { O ) seria impresso. Note que existe um espaço em branco 
antes e outro depois do valor o. Quando tentamos recuperar o valor de uma 
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chave que não está presente no mapa, o zero value do tipo armazenado é re- 
tornado. Muitas vezes isso pode causar comportamentos inesperados em um 
programa. Para evitar tais problemas, podemos testar se uma chave existe ou 
não: 


saoPaulo, encontrado := estados ["SP"] 
if encontrado { 
fmt.Println(saoPaulo) 


O segundo valor retornado pela operação de lookup é um bool que re- 
ceberá o valor true caso a chave esteja presente no mapa, ou false caso 
contrário. Algumas vezes precisamos testar se uma dada chave existe, mas 
não necessariamente precisamos do valor correspondente. Neste caso, pode- 
mos ignorar o valor atribuindo-o ao identificador vazio: 


_, encontrado := estados ["RJ"] 
if encontrado { 
N sa 
} 
Atualizando valores 


Para atualizar valores existentes em um mapa, utilizamos a mesma sintaxe 
da inserção de um novo valor. Porém, como as chaves são únicas, o valor 
armazenado será atualizado. Por exemplo: 


idades := map[string]int{ 


"João": 3T; 
"Ricardo": 26; 
"Joaquim": 41, 


idades ["Joaquim"] = 42 
fmt.Println(idades["Joaquim"]) 


O valor 42 seria impresso. 


58 


Casa do Código Capítulo 4. Coleções: arrays, slices e maps 


Removendo valores 


Podemos remover valores presentes em um mapa utilizando a função em- 
butida delete (), que possui a seguinte assinatura: 


func delete(m map [TipoChave] TipoValor, chave TipoChave) 


Por exemplo, caso desejássemos remover os dados do Estado do Ama- 
zonas no mapa de estados utilizado anteriormente, poderíamos fazê-lo desta 
forma: 


delete(estados, "AM") 


Iterando sobre mapas 


Podemos utilizar o operador range para iterar sobre todas as entradas 
de um mapa: 


for sigla, estado := range estados { 
fmt.Printf("ks (%s) possui %d habitantes.in", 
estado.nome, sigla, estado.populacao) 


Teríamos a saída: 


Goiás (G0) possui 6434052 habitantes. 

Paraíba (PB) possui 3914418 habitantes. 

Paraná (PR) possui 10997462 habitantes. 

Rio Grande do Norte (RN) possui 3373960 habitantes. 
Amazonas (AM) possui 3807923 habitantes. 

Sergipe (SE) possui 2228489 habitantes. 


Um detalhe importante que já foi mencionado é que a ordem dos elemen- 
tos em um mapa não é garantida. Em mapas pequenos como os que apresen- 
tamos até aqui, a ordem de inserção parece ter sido mantida, mas se tivermos 
um mapa com uma quantidade maior de elementos, veremos que isto não é 
sempre verdade. Por exemplo: 


quadrados := make(map[int]int, 15) 
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for i i= 1; i <= 15; i++ { 
quadrados[i] = i * i 


for n, quadrado := range quadrados { 
fmt .Printf("%d^2 = %d\n", n, quadrado) 


} 

Um exemplo da execução desse código seria: 
272 =4 
6-2 = 36 
10-2 = 100 
14-2 = 196 
252 
5-2 = 25 
9-2 = 81 
13-2 = 169 
4-2 = 16 
8-2 = 64 
12-2 = 144 
3-2 =9 
7-2 = 49 
11-2 = 121 
15-2 = 225 


Muitas vezes precisamos apresentar os dados seguindo uma ordem defi- 
nida. No caso do exemplo anterior, a leitura ficaria muito mais fácil se apre- 
sentássemos os valores ordenadamente. Em Go, a forma recomendada é man- 
ter uma estrutura de dados separada contendo as chaves ordenadas, iterando 
sobre esta estrutura e obtendo os valores correspondentes no mapa. Vamos 
adaptar o exemplo anterior para utilizar esta técnica, aproveitando as facilida- 
des do pacote sort para ordenar a lista de chaves. Crie um arquivo chamado 
cap4-mapa-ordenado/mapa ordenado. go com o seguinte conteúdo: 


package main 


import ( 
n" fmt n 
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" sort “ 


func main() { 
quadrados := make(map[int]int, 15) 


for n := 1; n <= 15; n} { 
quadrados [n] = n * n 


numeros := make([]int, 0, len(quadrados)) 


for n := range quadrados { 
numeros = append(numeros, n) 
} 


sort. Ints (numeros) 
for _, numero := range numeros { 


quadrado := quadrados [numero] 
fmt.Printf("Jd-2 = din", numero, quadrado) 


Agora sim, a saída do programa apareceria ordenada: 


$ go run cap4-mapa-ordenado/mapa ordenado.go 


1-2 = 1 
2-2 =4 
32 = 9 
4-2 = 16 
5-2 = 25 
6-2 = 36 
7-2 = 49 
8-2 = 64 
9-2 = 81 
10-2 = 100 
11-2 = 121 
12-2 = 144 
13-2 = 169 
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14-2 = 196 
15-2 = 225 


Repare no uso da função sort. Ints() para ordenar o slice contendo 
as chaves do mapa. Para maiores detalhes sobre as funções de ordenação 
disponíveis neste pacote, acesse a documentação oficial (em inglês) em http: 
/lgolang.org/pkg/sort/. 

Neste capítulo, vimos em detalhes os tipos nativos de coleção de dados, 
abstrações extremamente importantes e muito utilizadas no desenvolvimento 
de praticamente qualquer programa. 

No capítulo 5, veremos como criar abstrações ainda mais poderosas atra- 
vés de tipos customizados. 
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Criando novos tipos 


Criar tipos customizados é uma ferramenta de abstração muito poderosa em 
linguagens de programação. Go, comparada a linguagens puramente orien- 
tadas a objetos, tem um suporte limitado às características deste paradigma. 
Por exemplo, não é possível criar uma hierarquia de tipos baseada em he- 
rança. Composição de tipos, no entanto, é suportada e encorajada em Go. 

Dois tipos podem também implementar uma ou mais interfaces em co- 
mum, tornando-os ainda mais flexíveis. Veremos todas estas características 
nas próximas seções. 


51 Novos NOMES PARA TIPOS EXISTENTES 


Algumas linguagens dinâmicas - como Ruby — possibilitam que o programa- 
dor altere o comportamento de qualquer classe ou objeto durante a execução 
de um programa. Em Go isto não é possível, mas podemos estender tipos 
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existentes através da criação de novos tipos, por conveniência ou simples- 
mente para melhorar a legibilidade de um programa. 

Para demonstrar esta técnica, vamos criar um novo tipo chamado 
ListaDeCompras baseado em um slice de strings: 


type ListaDeCompras []string 


func main() 1 
lista := make(ListaDeCompras, 6) 
lista[0] = "Alface" 
lista[1] = "Pepino" 
lista[2] = "Azeite" 
lista[3] = "Atum" 
lista[4] = "Frango" 
lista[5] = "Chocolate" 


fmt.Println(lista) 


O código anterior imprimiria [Alface Pepino Azeite Atum 
Frango Chocolate]. 

Inicialmente, o tipo ListaDeCompras não parece muito útil. Porém, 
a grande vantagem em criar tipos customizados é que podemos estendê-los, 
algo impossível de se fazer com os tipos padrões da linguagem. Vamos es- 
tender o tipo ListaDeCompras para facilitar a nossa vida quando formos 
ao supermercado, definindo um método que separa os elementos da lista em 
categorias: 


func (lista ListaDeCompras) Categorizar() ( 
string, []string, []string) 1 


var vegetais, carnes, outros []string 


for _, e := range lista { 
switch e { 
case "Alface", "Pepino": 
vegetais = append(vegetais, e) 
case "Atum", "Frango": 
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carnes = append(carnes, e) 
default: 
outros 


append(outros, e) 


return vegetais, carnes, outros 


Considerando a mesma lista de compras do exemplo anterior, podería- 
mos categorizá-la da seguinte forma: 


vegetais, carnes, outros := lista.Categorizar() 
fmt.Printin("Vegetais:", vegetais) 
fmt.Println("Carnes:", carnes) 
fmt.Println("Outros:", outros) 


Agora temos três slices distintos contendo os elementos da lista de com- 
pras categorizados, e executando este código teríamos o seguinte resultado: 


Vegetais: [Alface Pepino] 
Carnes: [Atum Frango] 
Outros: [Azeite Chocolate] 


Repare na forma com que o comando switch foi utilizado na imple- 
mentação do método Categorizar (), verificando múltiplos valores — se- 
parados por vírgulas — em algumas das cláusulas case. Também utilizamos a 
cláusula default para criar um slice chamado outros, contendo qualquer 
valor que não foi reconhecido pelas cláusulas case especificadas anterior- 
mente. 


5.2 CONVERSÃO ENTRE TIPOS COMPATÍVEIS 


Apesar do tipo ListaDeCompras ter sido criado com base no tipo 
[] string, na prática eles são diferentes e não são automaticamente inter- 
cambiáveis. Desta forma, não é possível utilizar um valor ListaDeCompras 
em que um []stringé esperado e vice-versa. 
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Para contornar este problema, precisamos realizar uma conversão de ti- 
pos (operação conhecida em Go como type conversion) manualmente. Po- 
demos converter um valor para outro tipo utilizando o formato T (x), onde 
Téo tipo destino e x o valor a ser convertido. Vejamos um exemplo con- 
vertendo valores entre ListaDeCompras e []string. Crie um arquivo 
chamado cap5-conversao/conversao.go com o conteúdo: 


package main 
import "fmt" 
type ListaDeCompras []string 


func imprimirSlice(slice []string) 1 
fmt.Println("Slice:", slice) 


func imprimirLista(lista ListaDeCompras) { 
fmt.Println("Lista de compras:", lista) 


} 


func main() { 
lista := ListaDeCompras{"Alface", "Atum", "Azeite"} 
slice := []string{"Alface", "Atum", "Azeite"} 


imprimirSlice([]string(lista)) 
imprimirLista(ListaDeCompras(slice)) 


Podemos agora executar este programa e verificar o resultado da conver- 
são entre os tipos: 


$ go run cap5-conversao/conversao.go 
Slice: [Alface Atum Azeite] 
Lista de compras: [Alface Atum Azeite] 
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5.3 CRIANDO ABSTRAÇÕES MAIS PODEROSAS 


Já vimos no capítulo 4 que podemos facilmente manipular slices utilizando 
apenas operações de slicing e a função append (). Podemos também criar 
uma camada de abstração sobre os slices e implementar uma lista genérica que 
armazena valores de qualquer tipo e possui operações para remover valores 
do início, do meio e do fim da lista. Primeiro vejamos a definição do tipo 
propriamente dito: 


type ListaGenerica []interface{} 


Criamos um tipo chamado ListaGenerica baseado em um slice que 
armazena valores do tipo interface { }, o que permite que a lista armazene 
valores de qualquer tipo. 

Agora podemos criar os métodos, começando pelo método que remove 
valores de um índice específico: 


func (lista *ListaGenerica) RemoverIndice( 
indice int) interface() 1 


1 := *lista 

removido := 1[indice] 

*lista = append(1[0:indice], 1[indice+1:]...) 
return removido 


Repare que definimos o tipo do receptor como +ListaGenerica -um 
ponteiro para um valor do tipo ListaGenerica - pois desejamos alterar 
o conteúdo da lista. Inicialmente definimos uma variável 1 para facilitar as 
operações sobre o ponteiro. Depois atribuímos o valor presente no índice es- 
pecificado da lista à variável removido, que será retornada ao final do mé- 
todo. Tendo o valor desejado em mãos, alteramos a lista para desconsiderar 
o elemento removido, e finalmente retornamos o valor removido. 

Para implementar o método que remove valores do início da lista, pode- 
mos simplesmente chamar o método RemoverIndice () passando 0 como 
argumento: 
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func (lista *ListaGenerica) RemoverInicio() interface() { 
return lista.RemoverIndice(0) 


Isto funciona porque, substituindo o indice na operação que altera a 
lista por 0, obtemos a expressão append(1[0:0], 1[1:]...),0ouseja, 
adicionamos os elementos da lista iniciando no índice 1 à lista vazia retor- 
nada pela operação 1[0:0]. 

De maneira análoga, podemos implementar o método que remove valo- 
res do final da lista, novamente recorrendo ao método RemoverIndice (), 
agora passando o último índice da lista como argumento: 


func (lista *ListaGenerica) RemoverFim() interface() 1 
return lista.RemoverIndice(len(*lista)-1) 


O que ocorre neste caso é o inverso do que vimos com o método 
RemoverInicio(). Assumindo que o último índice presente na lista 
seja 5, podemos substituir o valor de indice para obter a expressão 
append(1[0:5], 1[6:]),0useja, adicionamos a lista vazia retornada por 
1[6:] à lista da qual o valor do índice 5 foi removido. 

A seguir está a listagem completa do programa. Crie um novo arquivo 
chamado cap5-lista-generica/lista.go com o conteúdo: 


package main 
import "fmt" 
type ListaGenerica [Jinterface() 


func (lista *ListaGenerica) RemoverIndice( 
indice int) interface() { 


1 := *lista 

removido := 1[indice] 

*lista = append(1[0:indice], 1[indice+1:]...) 
return removido 
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func (lista *ListaGenerica) RemoverInicio() interface() ( 
return lista.RemoverIndice(0) 


F 


func (lista *ListaGenerica) RemoverFim() interface{} { 
return lista.RemoverIndice(len(+*lista)-1) 


} 


func main() { 
lista := ListaGenerica( 
Li "Gafô”, 42, trhas 23; "Bola", 3:14, falsa; 


fmt.Printf("Lista original:inkvinin", lista) 


fmt.Printf( 
"Removendo do início: %v, após remoção: injvin", 
lista.RemoverInicio(), lista) 

fmt .Printf( 
"Removendo do fim: %v, após remoção:Anjvin", 
lista.RemoverFim(), lista) 

fmt.Printf( 
"Removendo do índice 3: %v, após remoção:injvin", 
lista.RemoverIndice(3), lista) 

fmt .Printf( 
"Removendo do indice O: %v, após remoção:Anyvin", 
lista.RemoverIndice(0), lista) 

fmt .Printf( 
"Removendo do último índice: %v, após remoção:\nýv\n", 
lista.RemoverIndice(len(lista)-1), lista) 


Ao executar este programa, veremos o seguinte resultado: 


$ go run cap5-lista-generica/lista.go 
Lista original: 
[1 Café 42 true 23 Bola 3.14 false] 


Removendo do início: 1, após remoção: 
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[Café 42 true 23 Bola 3.14 false] 


Removendo do fim: false, após remoção: 
[Café 42 true 23 Bola 3.14] 


Removendo do índice 3: 23, após remoção: 
[Café 42 true Bola 3.14] 


Removendo do índice O: Café, após remoção: 
[42 true Bola 3.14] 


Removendo do último índice: 3.14, após remoção: 
[42 true Bola] 


5.4 STRUCTS 


Uma struct (estrutura) é simplesmente uma coleção de variáveis que formam 
um novo tipo. Structs são importantes para agrupar dados relacionados, cri- 
ando a noção de registros. Já vimos um exemplo básico disso no capítulo 3.2, 
quando implementamos uma pilha baseada numa struct simples. 

Se estivéssemos desenvolvendo um programa para extrair estatísticas de 
um arquivo de texto, poderíamos definir a struct Arquivo da seguinte forma: 


type Arquivo struct { 
nome string 
tamanho float64 
caracteres int 
palavras int 
linhas int 


Com astruct definida, podemos criar uma instância especificando o valor 
dos campos na ordem em que eles foram definidos e separados por vírgulas: 


arquivo := Arquivo("artigo.txt", 12.68, 12986, 1862, 220} 


fmt.Println(arquivo) 
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Desta forma, teríamos o valor (artigo.txt 12.68 12986 1862 
220) impresso. 

Por questões de clareza, podemos especificar os nomes dos campos ao ini- 
cializar uma struct. Isto pode ser especialmente útil quando não precisamos 
atribuir valores a todos os campos no momento da inicialização, e também 
elimina a necessidade de declarar os valores na ordem em que foram defini- 
dos. Por exemplo: 


codigoFonte := Arquivo(tamanho: 1.12, nome: "programa.go")j 
fmt.Println(codigoFonte) 


Este código produziria (programa.go 1.12 0 0 0J comoresultado. 
Note que os valores que não foram especificados ( caracteres, palavras 
e linhas) foram inicializados com 0, o zero value para o tipo int. 

Para acessar os valores em uma struct, utilizamos o operador . separando 
o nome da variável e o nome do campo acessado: 


arquivo := Arquivol"artigo.txt", 12.68, 12986, 1862, 220} 
codigoFonte := Arquivoltamanho: 1.12, nome: "programa.go"} 


fmt .Printf("%s\t%.2fKB\n", arquivo.nome, arquivo.tamanho) 
fmt .Printf("%s\t%.2fKB\n", 

codigoFonte.nome, 

codigoFonte.tamanho) 


Esse programa imprimiria o seguinte resultado: 


artigo.txt 12.68KB 
programa.go 1.12KB 


Em programas maiores, é muito comum inicializar uma struct e armaze- 
nar um ponteiro para ela numa variável que será manipulada posteriormente. 
Para isso, utilizamos o operador &, que retorna um ponteiro para a struct cri- 
ada. Por conveniência, ao manipular um ponteiro para uma struct podemos 
omitir o operador +. Na prática, isso não influencia a forma como utilizamos 
a variável, como podemos ver a seguir: 
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ponteiroArquivo := &Arquivo(tamanho: 7.29, nome: "arquivo.txt"J 


fmt .Printf("%s\th.2fKB\n", 
ponteiroArquivo.nome, 
ponteiroArquivo.tamanho) 


Qualquer valor armazenado em uma struct pode ser alterado — structs 
são tipos mutáveis: 


codigoFonte := Arquivo(tamanho: 1.12, nome: "programa.go") 
fmt .Printf("%s\th.2fKB\n", 

codigoFonte.nome, 

codigoFonte.tamanho) 


codigoFonte.tamanho = 23.42 

fmt.Printf("hsity.2fKBin", 
codigoFonte.nome, 
codigoFonte.tamanho) 


Executando esse código veríamos os seguintes valores impressos: 


Antes: programa.go 1.12KB 
Depois: programa.go 23.42KB 


Em lingugens orientadas a objetos tradicionais, definimos novos tipos 
usando classes, que reunem dados (estado) e métodos (comportamento) em 
uma mesma unidade — a própria classe. 

Em Go, utilizamos structs para definir novos tipos. Assim como fize- 
mos anteriormente quando definimos tipos que estendem os tipos padrão da 
linguagem, podemos também definir métodos cujos receptores são structs, 
atingindo na prática um efeito muito semelhante à definição de uma classe. 

Vamos enriquecer nosso tipo Arquivo criando dois métodos — 


TamanhoMedioDePalavra() e MediaDePalavrasPorLinha(): 


func (arq *Arquivo) TamanhoMedioDePalavra() float64 1 
return float64(arq.caracteres) / float64(arq.palavras) 
} 


func (arq *Arquivo) MediaDePalavrasPorLinha() float64 1 
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return float64(arq.palavras) / float64(arq.linhas) 


func main() { 
arquivo := Arquivol"artigo.txt", 12.68, 12986, 1862, 220} 


fmt.Printf ("Média de palavras por linha: %.2f\n", 
arquivo.MediaDePalavrasPorLinha()) 

fmt .Printf ("Tamanho médio de palavra: %.2f", 
arquivo.TamanhoMedioDePalavra()) 


A implementação desses métodos é bastante trivial. Executando a função 
main () teríamos o seguinte resultado: 


Média de palavras por linha: 8.46 
Tamanho médio de palavra: 6.97 


É importante notar a conversão de int para float 64 no momento da 
divisão, pois queremos que o resultado seja um número decimal. Quando 
dividimos dois ints, o resultado produzido é outro int ea parte decimal 
do número é truncada. Por exemplo, a divisão 2 / 3 produziria 0 como 
resultado. 


5.5 INTERFACES 


Uma interface é a definição de um conjunto de métodos comuns a um ou mais 
tipos. É o que permite a criação de tipos polimórficos em Go. 

Java possui um conceito muito parecido, também chamado de interface. 
A grande diferença é que, em Go, um tipo implementa uma interface im- 
plicitamente — basta que este tipo defina todos os métodos desta interface, 
não havendo a necessidade de palavras-chave como implements, extends etc. 
Por exemplo, vamos criar uma interface chamada Operacao, que define um 
único método Calcular (): 


type Operacao interface 1 
Calcular() int 
+ 
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Podemos agora criar um tipo chamado Soma contendo dois operandos, 
e implementar o método Calcular (). Para facilitar a leitura dos resulta- 
dos, vamos também implementar o método String (), que retorna uma 
representação textual da operação de soma. Este método é invocado automa- 
ticamente quando queremos apresentar um valor utilizando o pacote fmt. 
Para implementá-lo, vamos utilizar a função Sprint f() do próprio pacote 
fmt, que retorna uma string formatada: 


type Soma struct { 
operandoi, operando2 int 


} 


func (s Soma) Calcular() int { 
return s.operandoi + s.operando2 


func (s Soma) String() string { 
return fmt.Sprintf("%d + Kd", s.operandol, s.operando2) 


} 


Para utilizar este tipo na prática, poderíamos simplesmente declarar e ins- 
tanciar uma variável do tipo Soma. Entretanto, prestando um pouco mais 
de atenção, podemos ver que a assinatura do método Calcular () do tipo 
Soma satisfaz a definição da interface Ope racao, e isto é suficiente para di- 
zer quea Soma é uma Operacao. Desta forma, podemos atribuir um valor 
Soma a uma variável definida como sendo do tipo Operacao: 


var soma Operacao 
soma = Soma{10, 20} 


fmt.Printf("hv = Kdin", soma, soma.Calcular()) 


Repare na forma como utilizamos o marcador %v para obter a represen- 
tação string de uma Soma - neste caso, 10 + 20. Assim, executando este 
código teríamos o resultado 10 + 20 = 30. 

Um único tipo não é suficiente para demonstrar a flexibilidade de uma in- 
terface. Então, vamos agora criar um novo tipo chamado Subtracao, tam- 
bém implementando a interface Operacao. Em seguida criaremos uma lista 
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de operações que serão calculadas independente do tipo. Primeiro, vamos ao 
código do tipo Subtracao: 


type Subtracao struct { 
operandoií, operando2 int 


} 


func (s Subtracao) Calcular() int { 
return s.operandoi - s.operando2 


func (s Subtracao) String() string { 
return fmt.Sprintf("%d - %d", s.operandoi, s.operando2) 
+ 


Vamos agora criar uma lista de operações e calcular o va- 
lor acumulado de todas elas. Crie um novo arquivo chamado 
cap5-operacoes/operacoes.go. Adicione a ele as definições dos 
tipos Operacao, Soma e Subtracao da forma como foram apresentados 
anteriormente e, por fim, crie a seguinte função main (): 


func main() { 
operacoes := make([]Operacao, 4) 
operacoes [0] = Soma{10, 20} 
operacoes [1] = Subtracao(30, 15} 


operacoes [2] = Subtracao(10, 50} 
operacoes [3] = Soma(5, 2} 
acumulador := 0 

for _, op := range operacoes { 


valor := op.Calcular() 
fmt.Printf("Jv = Kdin", op, valor) 
acumulador += valor 

+ 


fmt.Println("Valor acumulado =", acumulador) 


Veja um exemplo da execução deste programa: 
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$ go run cap5-operacoes/operacoes.go 


10 + 20 = 30 
30 - 15 = 15 
10 - 50 = -40 
5S+2=7 


Valor acumulado = 12 


5.6 DUCK TYPING E POLIMORFISMO 


Duck typing (ou tipagem pato, em português literal) é a capacidade de um 
sistema de tipos de determinar a semântica de um dado tipo baseado em seus 
métodos e não em sua hierarquia. O nome tem origem no chamado duck test 
(ou teste do pato): se faz “quack” como um pato e anda como um pato, então 
provavelmente é um pato. 

É mais comum encontrar esta propriedade em linguagens dinamicamente 
tipadas como Ruby ou Python. Porém, como Go não permite herança mas 
os tipos implementam interfaces implicitamente, na prática considera-se que 
Go implementa uma forma de duck typing, com a grande vantagem de ter, 
em tempo de compilação, a garantia de que o tipo esperado como argumento 
implementa a interface desejada. 

Para facilitar o entendimento, vamos alterar o exemplo anterior e ex- 
trair o código que calcula o valor acumulado da lista de operações da função 
main () para uma nova função: 


func acumular(operacoes []0peracao) int 1 
acumulador := 0 


for _, op := range operacoes { 
valor := op.Calcular() 


fmt.Printf("hv = Ydin", op, valor) 
acumulador += valor 


return acumulador 


Desta forma, poderíamos reutilizar a função acumular () passando 
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como argumento um slice contendo quaisquer objetos que implementassem 
o método Calcular (), retornando um int. 

Para demonstrar este fato, vamos adicionar ao arquivo 
cap5-operacoes/operacoes.go a definição de um novo tipo Idade 
implementando o método Calcular (). Vamos alterar também a função 
main() para chamar a função acumular () utilizando objetos deste tipo 
para obter a idade acumulada: 


type Idade struct { 
anoNascimento int 


} 


func (i Idade) Calcular() int { 
return time.Now().Year() - i.anoNascimento 


func (i Idade) String() string { 
return fmt.Sprintf ("Idade desde Kd", i.anoNascimento) 


func main() 1 
operacoes := make([]Operacao, 4) 
operacoes [0] = Soma{10, 20} 
operacoes[1] = Subtracao(30, 15) 
operacoes [2] Subtracao(10, 50} 
operacoes [3] = Soma{5, 2} 


fmt.Println("Valor acumulado =", acumular (operacoes)) 


idades := make([]Operacao, 3) 
idades [0] = Idade(1969) 
idades [1] = Idade(1977) 
idades [2] = Idade(2001+ 


fmt.Println("Idades acumuladas =", acumular (idades)) 


Assumindo 2014 como o ano atual, um exemplo da execução deste pro- 
grama seria: 
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$ go run cap5-operacoes/operacoes.go 


10 + 20 = 30 
30 - 15 = 15 
10 - 50 = -40 
5B+2=7 


Valor acumulado = 12 
Idade desde 1969 = 45 
Idade desde 1977 
Idade desde 1999 = 15 
Idades acumuladas = 97 


Il 
w 
q 


5.7 UM EXEMPLO DA BIBLIOTECA PADRÃO: 
IO.READER 


A biblioteca padrão é sempre uma boa referência para boas práticas. Por- 
tanto, vamos recorrer a uma interface muito importante presente nela: 
io.Reader. Esta interface define um único método Read () com a seguinte 
assinatura: 


func Read(p []byte) (n int, err error) 


Esta função lêaté len (p) bytes, armazena estes bytes em p e retorna o 
número de bytes lidos em caso de sucesso, ou um error em caso de erro na 
leitura. 

Como pudemos ver anteriormente, qualquer objeto que implemente o 
método Read () com a mesma assinatura poderá ser usado em um contexto 
onde um io.Reader é esperado. 

Vamos criar um exemplo simples de io.Reader. Para isso, vamos criar 
um novo arquivo chamado cap5-leitor/leitor.go declarando as se- 
guintes dependências: 


import ( 
" fmt " 
" io " 
) 


Agora vamos definir um novo tipo simples chamado 
LeitorDeStrings, que não possui nenhum atributo e implementa 
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somente o método Read (), retornando um slice de bytes - []byte 
- contendo uma string ASCII simples, porém respeitando a interface 


io.Reader: 


type LeitorDeStrings struct(J 


func (1 LeitorDeStrings) Read(p []byte) (int, error) 1 


plo] = °A? 
pl = °R? 
pI = ºC? 
p[3] = 9D? 


return len(p), nil 


Em seguida vamos implementar uma função chamada lersString(), 
que recebe como argumento um io.Reader, chama seu método Read (), 
converte o slice de bytes resultante em uma string propriamente dita e a 
retorna: 


func lerString(r io.Reader) string 1 
p := make([]byte, 4) 
r.Read(p) 
return string(p) 


Por fim, na função main(), vamos criar uma instância de 
LeitorDeStrings e utilizá-la como um Jio.Reader ao chamar a 
função lerString (), imprimindo seu resultado: 


func main() 1 
leitor := LeitorDeStringst) 
fmt.Println(lerString(leitor)) 


A seguir você encontra a listagem completa do arquivo 


cap5-leitor/leitor.go: 


package main 
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import ( 
"fmt " 
" io n 
) 


type LeitorDeStrings struct() 


func (1 LeitorDeStrings) Read(p []byte) (int, error) 1 
plo] = °A? 


p[i] = 9B? 
p[2] = 209 
p[3] = 2Dº 


return len(p), nil 


func lerString(r io.Reader) string { 
p := make([Ibyte, 4) 
r.Read(p) 
return string(p) 


func main() { 
leitor := LeitorDeStrings() 
fmt.Println(lerString(leitor)) 


Um exemplo da saída produzida por este programa: 


$ go run cap5-leitor/leitor.go 
ABCD 


Além do uso da interface io. Reader, há uma outra novidade no exem- 
plo anterior: o uso de caracteres literais - que em Go são do tipo rune. Este 
tipo foi criado para representar um código Unicode em 32 bits - rune é um 
alias para o tipo int 32. 

De fato, a codificação Unicode é tão importante em Go que toda string 
e o próprio código-fonte são codificados como UTF-8 por padrão. Ken 
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Thompson e Rob Pike, dois dos criadores da linguagem, foram também res- 
ponsáveis pela implementação original do padrão UTF-8. Desta forma, qual- 
quer caractere UTF-8 pode ser utilizado livremente em programas escritos 
em Go. 

Neste capítulo, aprendemos a criar novos tipos e abstrações baseados em 
structs e interfaces. Também conhecemos um pouco sobre a impor- 
tante interface io. Reader, presente na biblioteca padrão. 

No capítulo ??, veremos em detalhes os recursos para a criação e mani- 
pulação de funções. 
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CAPÍTULO 6 


Funções 


Até agora já criamos diversas funções em diferentes contextos. Criamos in- 
clusive uma função recursiva quando implementamos o algoritmo quicksort 
no capítulo 2.6. Também já vimos como criar objetos e adicionar métodos 
que definem seu comportamento. 

Neste capítulo veremos em detalhes todos os recursos disponíveis em Go 
para escrever funções. 


6.1 Å FORMA BÁSICA 


Apenas para relembrar, utilizamos a palavra-chave func para declarar uma 
nova função. Por exemplo, uma função que não recebe nenhum argumento 
e não retorna nenhum valor pode ser declarada da seguinte forma: 


func ImprimirVersao() 1 
fmt.Println("1.12") 


6.1. A forma básica Casa do Código 


Argumentos são declarados de maneira similar a variáveis, portanto, es- 
pecificamos primeiro seu nome, e depois seu tipo: 


func ImprimirSaudacao (nome string) { 
fmt.Printf("Olá, %s!\n", nome) 


k 
Múltiplos argumentos são separados por vírgulas: 


func ImprimirDados (nome string, idade int) 1 
fmt.Printf("hs, Kd anos.in", nome, idade) 


k 


E, caso os argumentos sejam do mesmo tipo, podemos especificá-lo uma 
única vez: 


func ImprimirSoma(a, b int) 1 
fmt.Printin(a + b) 
} 


Isto funciona inclusive quando a função recebe mais argumentos de ou- 
tros tipos. A declaração pode ser feita da seguinte forma: 


func ImprimirSoma(a, b int, texto string) { 
fmt.Printf("hs: %d\n", texto, a + b) 
$ 


Para retornar um valor, especificamos seu tipo ao final da declaração e 
utilizamos a palavra-chave return para retorná-lo: 


func Somar(a, b int) int { 
return a + b 


Podemos também especificar múltiplos valores de retorno, de forma bas- 
tante similar à lista de argumentos: 
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func PrecoFinal (precoCusto float64) (float64, float64) { 
fatorLucro := 1.33 
taxaConversao := 2.34 


precoFinalDolar := precoCustoDolar * fatorLucro 


return precoFinalDolar, precoFinalDolar * taxaConversao 


6.2 VALORES DE RETORNO NOMEADOS 


Os valores retornados por uma função podem ser nomeados no momento 
da declaração, fazendo com que eles estejam automaticamente disponíveis 
como variáveis no corpo da função. Desta forma, podemos utilizar a palavra- 
chave return sem especificar nenhum valor; os valores atuais das variáveis 
declaradas na definição da função serão retornados. Vejamos um exemplo, 
reescrevendo a função PrecoFinal () apresentada anteriormente: 


func PrecoFinal (precoCusto float64) ( 
precoDolar float64, 
precoReal float64) 1 


fatorLucro := 1.33 
taxaConversao := 2.34 


precoDolar = precoCusto * fatorLucro 
precoReal = precoDolar * taxaConversao 


return 


F 


func main() { 
precoDolar, precoReal := PrecoFinal (34.99) 


fmt .Printf ("Preço final em dólar: %.2f\n" + 


"Preço final em reais: %.2f\n", 
precoDolar, precoReal) 
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Repare que no corpo da função atribuímos os valores às variáveis 
precoDolar e precoReal diretamente utilizando o operador =, pois elas 
já foram declaradas na definição da função. 

Nomear os valores de retorno é uma ótima maneira de documentar uma 
função. No exemplo modificado, definimos que a função retorna dois valores 
específicos - precoDolar e precoReal - tornando sua intenção muito 
mais clara. No entanto, utilizar a palavra-chave return sem especificar os 
valores retornados dificulta o entendimento do código. Por isso é sempre re- 
comendável especificar os valores retornados explicitamente, mesmo que eles 
já tenham sido nomeados na assinatura da função. 

A seguir, vamos modificar novamente a função PrecoFinal () para dei- 
xar explícito quais são os valores retornados. Crie um novo arquivo chamado 
cap6-retornos-nomeados/precos. go com o conteúdo: 


package main 

import "fmt" 

func PrecoFinal (precoCusto float64) ( 
precoDolar float64, 


precoReal float64) 1 


fatorLucro := 1.33 
taxaConversao := 2.34 


precoDolar = precoCusto * fatorLucro 
precoReal = precoDolar * taxaConversao 


return precoDolar, precoReal 

func main() { 
precoDolar, precoReal := PrecoFinal(34.99) 
fmt.Printf("Preço final em dólar: %.2f\n" + 


"Preço final em reais: %.2f\n", 
precoDolar, precoReal) 
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Executando este programa, teríamos o seguinte resultado: 


$ go run cap6-retornos-nomeados/precos.go 
Preço final em dólar: 46.54 
Preço final em reais: 108.90 


6.3 ARGUMENTOS VARIÁVEIS 


Uma função pode receber um número variável de argumentos. Funções deste 
tipo são conhecidas em Go como variadic functions. Já utilizamos algumas 
delas, como por exemplo fmt.Printf() e append(). 

Para criar uma variadic function, devemos preceder o tipo do último (ou 
único) argumento com reticências. Na prática, as reticências indicam que a 
função pode receber zero ou mais argumentos do tipo especificado. 

Vamos definir uma função que recebe uma lista variável de nomes de ar- 
quivos e cria cada um deles em um diretório temporário. Para isto, vamos 
utilizar algumas funções presentes no pacote os: 
func CriarArquivos(dirBase string, arquivos ...string) { 

for -+ nome := range arquivos { 
caminhoArquivo := fmt.Sprintf( 
"%s/%s.%s", dirBase, nome, "txt") 


arq, err := os.Create(caminhoArquivo) 
defer arq.Close() 
if err != nil { 


fmt .Printf ("Erro ao criar arquivo ks: %v\n", 
nome, err) 


os.Exit(1) 
F 
fmt .Printf("Arquivo %s criado.\n", arq.Name()) 
} 
$ 
Note o uso das reticências na declaração do argumento arquivos: 
arquivos ...string. 
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A implementação da função é trivial. Percorremos a lista de nomes de 
arquivos recebida e, para cada nome de arquivo, compilamos seu caminho 
completo a partir do diretório especificado em dirBase e utilizamos a fun- 
ção os.Create() para criá-lo em disco. Essa função recebe um caminho 
completo de arquivo e cria um arquivo novo no caminho especificado. Caso 
o arquivo em questão já exista, seu conteúdo será totalmente apagado, resul- 
tando em um arquivo vazio. 

Além de efetivamente criar o arquivo, a função os.Create() retorna 
um ponteiro para um objeto do tipo os.File representando o descritor do 
arquivo criado. Este descritor pode ser usado para realizar outras operações 
no arquivo. Neste exemplo, porém, apenas chamamos o método Name () 
para obter seu caminho completo. 

A função os.Create () também pode retornar um erro caso não seja 
possível criar o arquivo. Se isto acontecer, a execução será interrompida e o 
programa será encerrado através da chamada à função os.Exit (). 

Por fim, é importante notar o uso da palavra-chave de fer. Ela é utilizada 
para instruir o ambiente de execução Go a realizar uma tarefa imediatamente 
antes de a função atual retornar. É bastante comum utilizar de fer para ga- 
rantir que os recursos alocados pela função sejam liberados ao final de sua 
execução. Neste exemplo, chamamos o método Close () no descritor do ar- 
quivo criado para ter certeza de que ele será devidamente fechado e liberado. 

Como dito anteriormente, uma função com argumentos va- 
riáveis pode receber zero ou mais argumentos do tipo especi- 
ficado. Para entender melhor, crie um novo arquivo chamado 
cap6-variadic-functions/arquivos.go. Adicione a ele a fun- 
ção CriarArquivos() apresentada anteriormente e, então, adicione 
a seguinte função main() para realizar algumas chamadas à função 
CriarArquivos () com listas de argumentos diferentes: 


func main() { 


tmp := os.TempDir() 


CriarArquivos (tmp) 
CriarArquivos (tmp, "testel") 
CriarArquivos (tmp, "teste2", "teste3", "teste4") 
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Inicialmente criamos a variável tmp e atribuímos a ela o valor retornado 
por os. TempDir (). Essa função retorna o caminho do diretório temporário 
utilizado pelo ambiente de execução Go. Em seguida, chamamos a função 
CriarArquivos () em três cenários diferentes: inicialmente sem nenhum 
nome de arquivo; depois com um único nome de arquivo; e por fim, com três 
nomes de arquivos distintos. Ao final da execução, o resultado esperado é que 
os arquivos testel.txt, teste2.txt, teste3.txt e teste4.txt 
sejam criados em disco. 

À seguir encontramos um exemplo da saída da execução deste programa 
no Linux: 


$ go run cap6-variadic-functions/arquivos.go 
Arquivo /tmp/testel.txt criado. 
Arquivo /tmp/teste2.txt criado. 
Arquivo /tmp/teste3.txt criado. 
Arquivo /tmp/teste4.txt criado. 


Para verificarmos que os arquivos foram realmente criados, podemos lis- 
tar os arquivos do diretório temporário: 


$ ls -1 /tmp/ 
-rw-r--r-- 1 user group OB May 1 10:56 testel.txt 
-rW-r--r-- user group OB May 1 10:56 teste2.txt 


1 
-IW-r--r-- 1 user group OB May 1 10:56 teste3.txt 
i user group OB May 1 10:56 teste4.txt 


6.4 FUNÇÕES DE PRIMEIRA CLASSE 


Funções em Go são first-class citizens (cidadãos de primeira classe). Isso sig- 
nifica que funções podem ser passadas como parâmetro para outras, ou uti- 
lizadas como valores de retorno, e até mesmo como membros de uma struct 
ou coleção. 

Se você já trabalhou com funções e callbacks em JavaScript, lambdas em 
Ruby, Python ou Java (que finalmente introduziu expressões lambda na versão 
8), ou escreveu programas em qualquer linguagem puramente funcional — 
Lisp, Haskell, Scala, Erlang ou Clojure, para citar alguns exemplos -, já deve 
estar familiarizado com os conceitos que serão apresentados a seguir. 
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6.5 FUNÇÕES ANÔNIMAS 


Durante o desenvolvimento de uma aplicação é muito comum encontrarmos 
problemas que exigem algum tipo de manipulação de textos: substituição de 
caracteres acentuados, processamento de templates (modelos de documentos) 
etc. 

Uma das formas mais poderosas de resolver este tipo de problema é o 
uso de expressões regulares. Go disponibiliza uma série de facilidades para 
trabalhar com elas no pacote regexp, basta adicioná-lo à lista de pacotes 
especificados na cláusula import. 

Veja o exemplo a seguir: 


func main() { 
texto := "Anderson tem 21 anos" 
expr := regexp.MustCompile("Nd") 


fmt .Println(expr.ReplaceAlIString(texto, "3")) 


Inicialmente criamos a expressão regular expr através da função 
regexp.MustCompile (). Essa função recebe a expressão desejada em for- 
mato string, compila-a e retorna um ponteiro para um objeto do tipo 
regexp. Regexp, utilizado para interagir com a expressão compilada. Neste 
exemplo, criamos uma expressão regular que irá capturar qualquer caractere 
numérico ( \d, que precisa ser utilizado como uma sequência de escape den- 
tro da string, por isso utilizamos a dupla barra inversa). 

Com a expressão regular compilada em mãos, chamamos seu método 
ReplaceAllString(),especificando a string que deverá ser processada 
(Anderson tem 21 anos) e uma segunda string indicando o texto que 
irá substituir os números encontrados — neste caso, desejamos substituir os 
números 2 e 1 pelo número 3. Desta forma, executando a função main () 
apresentada, teríamos o texto Anderson tem 33 anos impresso. 

Esta é a forma mais comum de substituição de textos utilizando expres- 
sões regulares. No entanto, em alguns casos precisamos construir processa- 
dores mais complexos. Por exemplo, desejamos transformar a primeira letra 
de cada palavra em maiúscula. É impossível resolver este problema usando 
uma substituição simples como a do exemplo anterior. 
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Para resolver esses casos, objetos do tipo regexp.Regexp pos- 
suem um método similar ao  ReplaceAllString(), chamado 
ReplaceAllStringFunc() que, em vez de uma string, aceita 
uma função como segundo argumento. Ela deve, por sua vez, receber uma 
string como argumento e retornar outra string transformada. Neste 
caso, utilizamos a função ToUpper () do pacote strings para transformar 
a string recebida em maiúsculas: 


func main() { 
expr := regexp.MustCompile("\\b\\w") 
texto := "antonio carlos jobim" 


processado := expr.ReplaceAlIStringFunc( 
texto, 
func(s string) string { 
return strings.ToUpper(s) 
1d) 


fmt .Println (processado) 


Repare que definimos a função transformadora na própria chamada à 
função ReplaceAllStringFunc(). Repare também que a função defi- 
nida não possui um nome. Funções deste tipo — definidas no momento em 
que são utilizadas - são conhecidas como funções anônimas. 

Também podemos armazenar uma função anônima em uma variável, e 
nos referirmos a esta variável posteriormente. Vamos modificar o exemplo 
anterior para utilizar esta técnica. Adicione o seguinte código a um novo ar- 
quivo chamado cap6-funcoes-anonimas/regexp.go: 


package main 


import ( 
"fmt" 
"regexp" 
"strings" 
) 


91 


6.6. Closures Casa do Código 


func main() { 
expr := regexp.MustCompile("\\b\\w") 


transformadora := func(s string) string { 
return strings .ToUpper (s) 


texto := "antonio carlos jobim" 

fmt .Println (transformadora (texto)) 

fmt .Println (expr .ReplaceAllStringFunc ( 
texto, transformadora) ) 


Extraímos a mesma função anônima utilizada no exemplo anterior, 
agora a atribuindo à variável transformadora. É importante notar que 
transformadora não é o nome da função, é apenas um identificador 
para uma posição de memória que armazena uma função, que então utili- 
zamos em dois contextos distintos: primeiro, fazemos uma chamada expli- 
cita para transformar o texto antonio carlos jobimem maiúsculas; por 
fim, passamos a função transformadora como argumento para a função 
regexp. ReplaceAllStringFunc (), que irá então substituir apenas os 
caracteres capturados pela expressão regular expr. 

Executando esse exemplo, teríamos o seguinte resultado: 


$ go run cap6-funcoes-anonimas/regexp.go 


ANTONIO CARLOS JOBIM 
Antonio Carlos Jobim 


Para saber mais sobre os recursos do pacote regexp, visite http://golang. 


org/pkg/regex/. 


6.6 CLOSURES 


Funções definidas de forma anônima dentro de outra função herdam o con- 
texto de onde elas foram criadas. Para demonstrar este fato, vamos criar uma 
implementação da sequência de Fibonacci utilizando uma função anônima. 
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Crie um novo arquivo cap6-closures/fibonacci.go com o seguinte 


código: 
package main 
import "fmt" 


func main() { 
& Db :='0;.2 


fib := func() int { 


a, b= b, atb 
return a 
} 
for i := 0; i < 8; i+ { 
Enk: Printi Ka ", fib()) 
} 


Inicialmente, declaramos e inicializamos as variáveis a e b com os valores 
o e1, respectivamente, dentro da própria função main (). 

Em seguida, definimos a função anônima - atribuída à variável fib - 
que calcula a sequência de Fibonacci. Repare que esta função manipula di- 
retamente as variáveis a e b, atualizando seus valores a cada chamada. Esta 
propriedade de uma função poder manipular o contexto onde ela foi origi- 
nalmente definida é conhecida como closure (clausura em português, embora 
este termo seja raramente traduzido). 

Executando o programa criado anteriormente, teríamos o seguinte resul- 
tado: 


$ go run cap6-closures/fibonacci.go 
1123581321 
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6.7 HIGHER-ORDER FUNCTIONS 


Como já foi dito, funções em Go podem retornar outras funções ou recebê-las 
como argumentos. As funções que possuem estas características são conhe- 
cidas como higher-order functions (funções de ordem superior em português — 
novamente um termo raramente utilizado) e são parte fundamental de qual- 
quer linguagem de programação funcional. Apesar de a linguagem Go não 
ser uma linguagem funcional pura, ela disponibiliza algumas das poderosas 
abstrações introduzidas por este paradigma. 

Vamos extrair a função que calcula a sequência de Fibonacci — 
apresentada no exemplo anterior - para uma função externa chamada 
GerarFibonacci (), alterando-a para que receba a quantidade de nú- 
meros que deverão ser gerados. Também precisamos fazer com que 
esta função retorne outra função capaz de gerar a sequência de Fi- 
bonacci. Adicione o seguinte código a um novo arquivo chamado 


cap6-higher-order-functions/cronometro.go: 


package main 


import ( 
" fmt “ 
"time" 
) 


func GerarFibonacci(n int) func() 1 
return func() 1 
a, b:= 0,1 


fib := func() int { 
a, b= b, atb 


return a 

} 

for i := 0; i<n; im 
fmt.Printf("kd ", fib()) 
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É importante notar que, como queremos que a função 
GerarFibonacci () retorne outra função, definimos seu tipo de re- 
torno como sendo func () — uma função sem argumentos e que não retorna 
nenhum valor. 

Em seguida, vamos criar uma nova função chamada Cronometrar (), 
que receberá como argumento uma função qualquer e calculará seu tempo 
de execução, utilizando recursos do pacote time: 


func Cronometrar (funcao func()) { 
inicio := time.Now() 


funcao() 


fmt .Printf("\nTempo de execução: Ksinn", 
time.Since(inicio)) 


Assim como definimos que a função GerarFibonacci () retorna uma 
função, agora especificamos que a Cronometrar () recebe também uma 
função sem argumentos e sem valor de retorno chamada funcao do tipo 
func (). 

Primeiro, armazenamos o tempo atual - time.Now() - na variável 
inicio. 

Em seguida, chamamos a função recebida como argumento. Aqui 
fica claro o motivo pelo qual GerarFibonacci () retorna outra função: 
para que possamos calcular seu tempo de execução, precisamos contro- 
lar quando ela será chamada. Assim, passamos a função retornada por 
GerarFibonacci () como argumento para Cronometrar (), que por sua 
vez decide o momento apropriado para realizar a chamada. 

Por fim, utilizamos a função time.Since () para calcular o intervalo 
de tempo entre o momento atual e o momento armazenado em inicio. Ela 
retorna um valor do tipo time.Duration, que representa um período de 
tempo. Este tipo possui vários métodos úteis. Neste exemplo, porém, utiliza- 
mos apenas a representação string deste objeto para imprimir o tempo de 
execução da funcao. 
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Vamos agora criar uma função main () para cronometrar a geração da 
sequência de Fibonacci em três situações diferentes: 


func main() { 
Cronometrar (GerarFibonacci(8)) 
Cronometrar (GerarFibonacci(48)) 
Cronometrar (GerarFibonacci(88)) 


A seguir encontramos um exemplo da saída deste programa. Parte das 
sequências geradas foram omitidas para facilitar a visualização: 


$ go run cap6-higher-order-functions/cronometro.go 
1123581321 
Tempo de execução: 51.647us 


112358132134 55... 701408733 1134903170 1836311903 
2971215073 4807526976 
Tempo de execução: 66.315us 


1123658... 420196140727489673 679891637638612258 
1100087778366101931 
Tempo de execução: 130.485us 


Repare na representação do tempo de execução de cada função: 
51.647]us para gerar 8 números, 66.315us para gerar 48 números e 
130.485us para gerar uma sequência de 88 números. A função String () 
do tipo time.Duration decide automaticamente a unidade de tempo uti- 
lizada de acordo com o tamanho do período representado. Neste caso, a uni- 
dade utilizada foi o microssegundo (us). 

Para maiores informações sobre as funções e tipos disponíveis no pacote 
time, visite http://golang.org/pkg/time/. 


6.8 TIPOS DE FUNÇÃO 


No exemplo anterior, criamos uma função Cronometrar() que recebe 
como argumento uma outra função. Esta, por sua vez, não recebe nenhum 
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argumento e não retorna nenhum valor. Algumas vezes, no entanto, precisa- 
mos receber como argumento funções mais complexas e flexíveis. 

Uma das formas de obter tal flexibilidade é através da definição de tipos 
para funções (function types). 

Considere uma função de agregação que recebe uma lista de valores, um 
valor inicial e uma função agregadora: 


func Agregar( 

valores [Jint, 

inicial int, 

fn func(n, m int) int, 
piit f 

agregado := inicial 


for _, v := range valores { 
agregado = fn(v, agregado) 


return agregado 


Utilizando-a como base, podemos agora escrever uma função para calcu- 
lar a soma de uma série numérica: 


func CalcularSoma(valores []int) int { 
soma := func(n, m int) int { 
return n + m 


} 


return Agregar(valores, 0, soma) 


E também podemos escrever uma função para calcular o produto de uma 
série numérica: 


func CalcularProduto(valores []int) int { 
multiplicacao := func(n, m int) int 1 
return n * m 


F 
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return Agregar(valores, 1, multiplicacao) 


Podemos agora criar a função main () e utilizar as duas novas funções: 


func main() 1 
valores := []int(3, -2, 5, 7, 8, 22, 32, -1) 


fmt.Println(CalcularSoma(valores)) 
fmt.Printin(CalcularProduto (valores)) 


Para esta série, o programa imprimirá os valores 74 e 1182720 para a soma 
e o produto, respectivamente. 

Repare, porém, como o trecho func(n, m int) int aparece três ve- 
zes e causa confusão especialmente quando utilizado como argumento na de- 
finição da função Agregar (). 

Vamos extrair esta declaração comum para um tipo de função chamado 
Agregadora: 


type Agregadora func(n, m int) int 


Veja como a definição de um tipo de função não é muito diferente da 
definição de outros tipos. 

Na prática, um function type é muito semelhante a uma interface: qual- 
quer função que receba dois argumentos do tipo int e retorne um valor 
int satisfaz a assinatura definida pelo tipo Agregadora e, portanto, pode 
ser utilizada como uma função agregadora. 

Agora vamos modificar a função Agregar () para utilizar o novo tipo 
na declaração da lista de argumentos: 


func Agregar( 
valores [Jint, 
valorInicial int, 
fn Agregadora, 
> int À 
agregado := valorInicial 


98 


Casa do Código Capítulo 6. Funções 


for _, v := range valores { 
agregado = fn(v, agregado) 
} 


return agregado 


Assim tornamos muito mais legível a definição da função Agregar () 
e especialmente do argumento fn. Além disso, CalcularSoma() e 
CalcularProduto () não precisam sofrer nenhuma alteração, pois as fun- 
ções que ambas passam como argumento para Agregar () satisfazem im- 
plicitamente a assinatura de Agregadora. 


6.9 SERVINDO HTTP ATRAVÉS DE FUNÇÕES 


No capítulo 5.7 vimos um exemplo do uso de interfaces na própria biblioteca 
padrão da linguagem Go. Agora vamos recorrer novamente a ela para de- 
monstrar o uso de funções que recebem outras como argumento através de 
um function type. Para isso vamos utilizar um dos recursos mais importantes 
da biblioteca padrão: escrever um servidor HTTP. 

A maior parte dos recursos disponíveis para a escrita de servidores HTTP 
pode ser encontrada no pacote net /http (http://golang.org/pkg/net/http/) 


Nosso servidor será bastante simples e apenas retornará a data atual do 
sistema. 

A forma mais fácil de escrever este servidor em Go é através da função 
http.HandleFunc (), que recebe dois argumentos: primeiro, uma string 
definindo o padrão da URL atendida por este serviço, e por último, uma fun- 
ção do tipo http. HandlerFunc, que define a seguinte assinatura: 


type http.HandlerFunc func(http.ResponseWriter, *http.Request) 


Isso significa que qualquer função que possua a mesma assinatura pode 
ser usada como um servidor HTTP! 
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A implementação do serviço é bastante simples. Crie um novo ar- 
quivo chamado cap6-servidor-tempo/servidor tempo.go com o 
conteúdo: 


package main 


import ( 
"fmt" 
"net/http" 
"time" 

) 


func main() { 
http.HandleFunc( 
"/tempo", 
func(w http.ResponseWriter, r *http.Request) { 
fmt .Fprintf (w, "hs", 
time.Now().Format ("2006-01-02 15:04:05")) 
p 


http.ListenAndServe(":8080", nil) 


É muito importante notar que, na prática, um servidor HTTP em Go é um 
programa como outro qualquer, portanto, precisa definir um pacote main 
onde a função main () é o ponto de partida. Sendo assim, main () é o lugar 
ideal para configurarmos nosso serviço. 

Inicialmente, utilizamos a função http. HandleFunc () para registrá- 
lo, especificando que ele atenderá requisições recebidas na URL /tempo. 

Em seguida, especificamos uma função anônima que satisfaz a 
assinatura definida pelo tipo http.HandlerFunc, recebendo um 
http.ResponseWriter e um ponteiro para um objeto http. Request. 

A implementação desta função apresenta algumas novidades: utilizamos 
a função fmt .Fprintf() para imprimir a data e hora atual como resposta à 
requisição HTTP. Esta função é muito similar à fmt . Print f, que já usamos 
muitas vezes até aqui. A diferença é que Printf() escreve na saída padrão, 
enquanto Fprintf() recebe como primeiro argumento um valor do tipo 
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io.Writer, onde a saída será escrita — neste caso, utilizamos o valor rece- 
bido em w. Este valor é, na verdade, do tipo http. ResponseWriter, mas 
satisfaz a interface io. Writer e, portanto, pode ser utilizado neste contexto. 

Para formatar a data e hora atual, utilizamos o método Format () de- 
finido pelo tipo time.Time. Este método recebe como argumento uma 
string que define o formato desejado. A data escolhida para definir o for- 
mato no nosso exemplo não é aleatória: o método Format () utiliza esta data 
preestabelecida (2 de janeiro de 2006, 15:04:05) para analisar e reconhecer o 
formato recebido. 

Por fim, utilizamos a função http. ListenAndserve () para especifi- 
car que o servidor deverá aceitar conexões na porta 8080. Esta função ini- 
cia um servidor HTTP, bloqueia a execução do programa e delega as co- 
nexões recebidas no endereço definido para os serviços registrados. O se- 
gundo argumento é um valor do tipo http.Handler e, neste caso, foi 
especificado como nil pois já registramos um serviço através do método 
http.HandleFunc (). 

Podemos executar o servidor da mesma forma que executamos todos os 
outros programas: 


$ go run cap6-servidor-tempo/servidor tempo.go 


Caso o servidor tenha sido iniciado com sucesso, nenhuma saída será 
impressa. Para testar o serviço, abra seu navegador e direcione-o à URL 
http://localhost:8080/tempo . O resultado será uma página similar à demons- 
trada a seguir, com a data e a hora atuais: 
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se 
e C B localhost:8080/tempo 


/ | \ loøcalhost:8080/tempo x | 












2014-05-18 20:15:18 


Figura 6.1: exemplo de data e hora retornados pelo servidor de tempo 


Neste capítulo, vimos todos os recursos disponíveis para a criação e ma- 
nipulação de funções, incluindo funções anônimas, closures e funções de pri- 
meira classe. 

Também vimos como criar um servidor HTTP simples utilizando uma 
função para atender às requisições. 

No capítulo 7, veremos os recursos para a escrita de programas concor- 
rentes em Go. 
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Concorrência com goroutines e 
channels 


“Do not communicate by sharing memory; instead, share memory by 


communicating” 
— Effective Go 


Programação concorrente é um tema bastante delicado e complexo. Se 
você já escreveu programas que dependiam de múltiplas threads ou múltiplos 
processos sabe que é uma tarefa que exige muita atenção e paciência, especi- 
almente quando é necessário compartilhar estado entre as diferentes linhas 
de execução. 

A maior parte das linguagens de programação implementa threads de al- 
guma forma, seja através de um escalonador próprio ou delegando o controle 
para o sistema operacional hospedeiro. 


71. Goroutines Casa do Código 


O compartilhamento de estado em um programa multi-threaded é nor- 
malmente implementado através de variáveis globais e/ou compartilhadas e 
exige algum mecanismo de trava ou semáforo para evitar condições de cor- 
rida (race conditions). 

Para evitar este tipo de problema, Go implementa um modelo de concor- 
rência baseado em goroutines que se comunicam através de channels, sendo 
que o próprio ambiente de execução garante que apenas uma goroutine acesse 
um channel em um determinado momento. 

Existe um documento (em inglês) no site oficial da linguagem chamado 
Effective Go (http://golang.org/doc/effective go.html) que descreve uma sé- 
rie de boas práticas para garantir a escrita de programas com código limpo 
e idiomático em Go. Este documento contém a definição de um slogan que 
resume a ideologia por trás do modelo de concorrência escolhido: Do not 
communicate by sharing memory; instead, share memory by communicating 
(não comunique através de memória compartilhada; em vez disso, comparti- 
lhe memória através da comunicação). 


Nas próximas seções veremos como atingir este objetivo. 


71 (GGOROUTINES 


Uma goroutine é um tipo de processo extremamente leve. Na prática, uma 
goroutine é muito similar a uma thread. No entanto, goroutines são geren- 
ciadas pelo ambiente de execução da linguagem, que decide quando e como 
associá-las a threads do sistema operacional. 

Para iniciar uma goroutine, utilizamos a palavra-chave go seguida de 
uma chamada de função. O ambiente de execução irá executar a função cha- 
mada sem bloquear a linha de execução principal. 

Considere a seguinte função imprimir (), que recebe um número in- 
teiro e o imprime três vezes com um espaço de 200 milissegundos entre cada 
impressão: 


func imprimir(n int) { 
for i :=0; i<3; it 
fmt.Printf("Yd ", n) 
time.Sleep(200 * time.Millisecond) 
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Agora considere a seguinte função main() que chama a função 
imprimir () duas vezes com números diferentes: 


func main() { 
imprimir (2) 
imprimir(3) 


Executando esta função main() obteríamos 2 2 2 3 3 3 como re- 
sultado. 

Vamos alterar a primeira chamada para que seja executada em uma go- 
routine: 


func main() { 
go imprimir(2) 
imprimir(3) 


Através da simples adição da palavra-chave go, esta nova versão executa 
as duas chamadas de forma concorrente e produz um resultado completa- 
mente diferente: 3 23232. 

É importante ressaltar que as goroutines dependem da função main () 
para que continuem sua execução. Em outras palavras, as goroutines morrem 
quando a função main () finaliza sua execução. 

Podemos provar este fato com o simples programa a seguir, que inicia uma 
goroutine que dorme por 5 segundos, enquanto a função main () dorme por 
apenas 3 segundos: 


func dormir() { 
fmt.Println("Goroutine dormindo por 5 segundos...") 
time.Sleep(5 * time.Second) 
fmt.Println("Goroutine finalizada.") 


func main() { 
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go dormir() 


fmt.Println("Main dormindo por 3 segundos...") 
time.Sleep(3 * time.Second) 
fmt.Println("Main finalizada.") 


O resultado da execução deste programa seria o seguinte: 


Main dormindo por 3 segundos... 
Goroutine dormindo por 5 segundos... 
Main finalizada. 


A goroutine executando a função dormir () nunca termina, pois a fun- 
ção main () termina sua execução antes e o programa é finalizado. 


7.2 CHANNELS 


A capacidade de executar diferentes goroutines concorrentemente é muito 
importante e abre diversas possibilidades para a solução de problemas que 
exigem alta performance e melhor eficiência no uso de recursos de processa- 
mento. 

Entretanto, é muito rara a situação em que várias goroutines são dispara- 
das independentemente, sem que haja comunicação entre elas. Os channels 
foram criados como uma abstração para viabilizar esta comunicação. 

Um channel é um canal que conduz informações de um determinado tipo 
— qualquer tipo válido em Go. 

Para criar um novo canal, utilizamos a função make (). Por exemplo, 
para criar um canal capaz de trafegar valores do tipo int, podemos utilizar 
o seguinte comando: 


c := make(chan int) 


Para interagir com um canal, utilizamos o operador <- (conhecido como 
arrow operator, ou operador seta). A posição do canal em relação à seta indica 
a direção do fluxo da comunicação. Por exemplo, para enviar valores int 
para o canal c, utilizamos a seguinte notação: 
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ec <= 33 


E para receber um valor enviado para o canal c: 
valor := <-c 


A seguir temos um exemplo simples que combina todos os passos anteri- 
ores para demonstrar o fluxo de comunicação completo: 


func main() { 
c := make(chan int) 
go produzir(c) 


valor := <-c 
fmt .Println (valor) 
} 


func produzir(c chan int) { 
c <- 33 
} 


Inicialmente criamos um canal para trafegar valores do tipo int. 

Em seguida, disparamos uma goroutine executando a função 
produzir (), que recebe um canal como argumento e simplesmente 
envia um número inteiro para o canal recebido. 

Por padrão, operações de envio e recebimento em um canal bloqueiam até 
que o outro lado esteja pronto. Este fato permite que a própria comunicação 
entre duas goroutines garanta a sincronização entre elas, sem que nenhum 
mecanismo de travas seja necessário. 

Por este motivo, a próxima linha da função main () — que recebe um va- 
lor do canal — fará com que a linha de execução principal fique bloqueada até 
que algum valor seja enviado para o canal c. Assim que o valor 33 for enviado 
pela função produzir (),a linha de execução principal será então desblo- 
queada, o valor 33 será consumido, atribuído à variável valor e impresso no 
console. 
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7.3 BUFFERS 
Canais podem ser criados com um buffer. Por exemplo: 
c := make(chan int, 5) 


O canal c foi criado com um buffer de tamanhos. Isto quer dizer que ope- 
rações de envio não serão bloqueadas enquanto o buffer não estiver cheio, e 
operações de recebimento não serão bloqueadas enquanto o buffer não estiver 
vazio. Vejamos mais um exemplo para facilitar o entendimento: 


func main() { 
c := make(chan int, 3) 
go produzir(c) 


fmt.Println(<-c, <-c, <-c, <-c) 


} 

func produzir(c chan int) { 
c<-1 
c<-2 
c<- 3 


Criamos um canal com buffer de tamanho 3 e imediatamente disparamos 
uma goroutine que envia três valores pelo canal criado. Em seguida, rece- 
bemos quatro valores do canal e os imprimimos no console. Qual seria o 
resultado desse programa? 


fatal error: all goroutines are asleep - deadlock! 


Causamos um deadlock! A goroutine produtora encerrou sua execução 
logo após produzir os três valores; por causa do buffer, nenhuma das opera- 
ções de envio fez com que a execução fosse bloqueada. No entanto, ao ten- 
tarmos receber um quarto valor - que nunca foi produzido — pelo canal, a 
linha principal ficou bloqueada. O ambiente de execução detectou o deadlock 
e encerrou a execução do programa com um erro. 

O produtor precisa indicar de alguma forma que não enviará mais ne- 
nhum valor pelo canal. Para isso existe a função embutida close (). Vamos 


108 


Casa do Código Capítulo 7. Concorrência com goroutines e channels 


alterar a função produzir () para fechar o canal após produzir os três va- 
lores: 


func produzir(c chan int) 1 


c <- 1 
c <- 2 
c <- 3 
close(c) 


É muito importante que o lado produtor feche o canal sempre que possível 
quando não houver mais valores a serem produzidos. 

Agora, precisamos também detectar que o canal foi fechado do lado do 
consumidor. 

O operador <- retorna sempre dois valores: o valor lido e um valor bool 
indicando se o valor foi lido com sucesso ou não; este valor será false 
quando o canal tiver sido fechado. 

Até o momento, ignoramos o segundo valor retornado. Vamos alterar 
também a função main () para checá-lo: 


func main() { 
c := make(chan int, 3) 
go produzir (c) 


for { 
valor, ok := <-c 
if ok 1 
fmt.Println(valor) 
} else 1 
break 
} 
} 
} 
Qual seria o resultado do programa agora? 
1 
2 
3 
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Resolvemos o deadlock! Porém, o processo de checar sempre se o canal 
continua aberto ou não é bastante tedioso. 

Felizmente, há uma outra forma de fazê-lo: podemos utilizar o opera- 
dor range para ler valores de um canal conforme eles forem sendo produzi- 
dos. Vamos criar um exemplo para utilizá-lo. Em um novo arquivo chamado 
cap7-buffers/buffers.go, adicione a função produzir() apresen- 
tada no exemplo anterior: 


package main 
import "fmt" 


func produzir(c chan int) { 


c<-1 
c <- 2 
c <- 3 
close(c) 


Em seguida, crie a seguite função main (), parecida com a do exemplo 
anterior, porém utilizando o operador range: 


func main() { 
c := make(chan int, 3) 
go produzir(c) 


for valor := range c { 
fmt.Println(valor) 


O código resultante é menor e muito mais claro. 
Execute o programa e veja que o resultado é idêntico: 


$ go run cap7-buffers/buffers.go 
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7.4 CONTROLANDO A DIREÇÃO DO FLUXO 


Por padrão, a comunicação em um canal é bidirecional. Algumas vezes, po- 
rém, desejamos controlar a direção do fluxo quando passamos um canal como 
argumento para outra função, ou quando temos uma função que retorne um 
canal. 

Considerando ainda o exemplo anterior, vamos alterar a função 
produzir () para definir a direção da comunicação: 


func produzir(c chan<- int) 1 
PK toa 
+ 


Repare que, ao receber o canal como argumento, definimos que a função 
poderá somente enviar valores para o canal ( chan<-). Desta forma, caso a 
função tente receber valores pelo mesmo canal, causará o seguinte erro: 


invalid operation: <-c (receive from send-only type chan<- int) 


De maneira similar, podemos definir um canal read-only (somente lei- 
tura): 


func consumir(c <-chan int) { 
CF Sonia 
} 


Vale ressaltar que, como Go é uma linguagem com tipos fortes e os canais 
são tipados, esse erro é causado em tempo de compilação. 


7.5 SELECT 


É muito comum encontrar um cenário em que uma goroutine precisa inte- 
ragir com múltiplos canais de comunicação. Por exemplo, uma função pode 
disparar goroutines que escrevem valores em canais diferentes, e a função ori- 
ginal depende dos valores de todos estes canais para produzir seu resultado 
final. 

Para evitar que a execução de uma goroutine seja bloqueada esperando 
por operações em algum dos canais dos quais ela depende, Go fornece um 
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comando chamado select, que é muito semelhante ao switch. Sua forma 
geral é: 


select 1 
case vi: 


DE ai 


case v2 : 


// 
default: 
// 


<-canali: 


<-canal2: 


Caso exista algum valor a ser lido no canal1, ele será atribuído à variável 
v1 eo bloco associado ao primeiro comando case será executado. Caso con- 
trário, o canal2 será checado por valores recebidos e, em caso positivo, seu 
valor será atribuído à variável v2 e o bloco associado ao segundo comando 
case será executado. Se nenhum dos canais especificados possuírem valores 
prontos para serem lidos, o bloco default será executado. 

Uma das formais mais comuns do uso do select é dentro de um laço 
que controla a comunicação com as goroutines. Vamos escrever um programa 
que, dada uma lista de números, separa-os em duas listas distintas de pares e 
ímpares. O algoritmo é bastante trivial, porém, vamos implementá-lo usando 
uma goroutine e canais separados para enviar números pares e ímpares. Va- 
mos utilizar também um terceiro canal para indicar o final da execução da 
goroutine. 

Primeiro, vamos criar a função separar (), que recebe a lista de núme- 
ros e três canais: i, pp e pronto, todos unidirecionais: 


func separar (nums [Jint, i, p chan<- int, pronto chan<- bool) 1 


for ., n := range nums { 
if n42 = 0 { 
p<-n 
} else { 
i <- n 
E; 
} 


pronto <- true 
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Para cada número presente em nums, verificamos se é par (divisível por 
2- n$%2 == 0) e, em caso positivo, enviamos o número para o canal p; 
caso seja um número ímpar, ele será enviado para o canal i. Ao final da 
iteração, enviamos o valor true para o canal pronto, indicando o fim do 
processamento. 

Vamos agora seguir a função main () passo a passo. Inicialmente, cria- 
mos os canais e a lista de números: 


i, p, pronto := make(chan int), make(chan int) 
pronto := make(chan bool) 
nums := [Jint(i, 23, 42, 5, 8, 6, 7, 4, 99, 100) 


Em seguida, disparamos uma goroutine para separar os números: 
go separar (nums, i, p, pronto) 


Com tudo preparado e a goroutine já separando os valores, precisamos 
coletar os resultados enviados para cada canal. Primeiro, criamos as duas 
listas e uma variável para controlar o laço: 


var impares, pares [Jint 
fim := false 


Agora precisamos popular as listas impares e pares de acordo com a 
separação que está sendo feita na goroutine. Para isso, criamos um laço que 
executará até que o valor da variável fim seja verdadeiro, e utilizamos um 
comando select para ler os valores de cada um dos canais: 


for !fim 1 
select 1 
case n := <-i: 
impares = append(impares, n) 
case n := <-p: 


pares = append(pares, n) 
case fim = <-pronto: 


} 
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Repare na última cláusula case: ela só será executada quando a gorou- 
tine enviar o valor true para o canal pronto e, então, a variável fim as- 
sumirá o valor true e a condição de saída do laço será atendida. Utilizar 
um canal para sincronizar goroutines que envolvem múltiplos canais é uma 
técnica muito comum em Go. 

Por fim, imprimimos os valores separados presentes nas listas impares 


e pares: 
fmt.Printf("Ímpares: %v | Pares: %v\n", impares, pares) 
A seguir podemos ver o código completo da função main (): 


func main() { 
i, p := make(chan int), make(chan int) 
pronto := make(chan bool) 
nums := []int{1, 23, 42, 5, 8, 6, 7, 4, 99, 100) 


go separar (nums, i, p, pronto) 


var impares, pares [Jint 
fim := false 


for !fim { 
select { 
case n := <-i: 
impares = append(impares, n) 
case n := <-p: 
pares = append(pares, n) 
case fim = <-pronto: 
$ 
} 


fmt .Printf("Ímpares: %v | Pares: %v\n", impares, pares) 


Executando este programa, obteríamos o seguinte resultado: 


$ go run select.go 
ímpares: [1 23 5 7 99] | Pares: [42 8 6 4 100] 
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7.6 TEMPORIZADORES E TIMEOUTS 


Controlar a execução de múltiplas goroutines através de um select é uma téc- 
nica bastante simples e muito utilizada em Go. Porém, existem casos em que 
a execução de uma determinada tarefa precisa acontecer em um período li- 
mitado de tempo. 

O pacote time fornece uma função After () que ajuda a resolver estes 
casos. Sua assinatura é: 


func After(d Duration) <-chan Time 


Repare que esta função convenientemente retorna um canal. Assim, po- 
demos facilmente utilizá-la dentro de um select para controlar o tempo de 
execução de uma goroutine, e tomar alguma atitude caso ela não produza re- 
sultados dentro do tempo esperado. 

Vamos simular esta situação com uma goroutine que simples- 
mente dorme por 5 segundos e sinaliza o final de sua execução en- 
viando o valor true para um canal. Crie um arquivo chamado 
cap7-timeout /timeout.go e defina uma nova função executar () 
com o código da simulação: 


package main 


import ( 
u" fmt " 
"r ime " 
) 


func executar(c chan<- bool) { 
time.Sleep(5 * time.Second) 
c <- true 


Crie então o esqueleto da função main (), cujo conteúdo será apresen- 
tado em partes logo em seguida: 


func main() { 
Ties 
} 
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Primeiramente, devemos criar um canal e, então, disparar uma goroutine 
executando a tarefa demorada: 


c := make(chan bool, 1) 
go executar(c) 


fmt.Println("Esperando...") 


Suponha que o tempo máximo aceitável para a execução desta tarefa seja 
de 2 segundos. Vamos implementar um mecanismo de timeout utilizando 


time.After () dentro deum select enquanto esperamos que a tarefa seja 
finalizada: 


fim := false 
for !fim { 
select 1 
case fim = <-c: 
fmt.Println("Fim!'") 
case <-time.After(2 * time.Second): 
fmt.Println("Timeout !") 
fim = true 


Executando este programa teremos o seguinte resultado: 


$ go run cap7-timeout/timeout.go 
Esperando... 
Timeout! 


Simples, não? 
Se alterarmos a função executar () para dormir por apenas 1 segundo 
em vez de 5, teremos como resultado: 


$ go run cap7-timeout/timeout.go 
Esperando... 
Fim! 
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7.7 SINCRONIZANDO MÚLTIPLAS GOROUTINES 


Anteriormente, vimos um exemplo de como esperar que uma goroutine fi- 
nalize sua execução através da utilização de um canal. No entanto, quando 
precisamos esperar pela execução de múltiplas goroutines, controlar manual- 
mente quantas delas já terminaram pode se tornar uma tarefa sujeita a falhas. 

Go fornece um tipo chamado Wait Group, presente no pacote sync, que 
torna esta tarefa bem mais simples. Para vê-lo em ação, crie um arquivo cha- 
mado cap7-sincronizador/sincronizador.go, declarando o pacote 
sync entre suas dependências: 


package main 


import ( 
"fmt" 
"math/rand" 
n sync "“ 
"time" 

) 


Crie também a função main () com o conteúdo: 


func main() 1 
inicio := time.Now() 
rand.Seed(inicio.UnixNano()) 
var controle sync.WaitGroup 
for i := 0, à < By d+ 
controle. Add(1) 
go executar(&controle) 
} 


controle.Wait() 


fmt .Printf ("Finalizado em %s.\n", time.Since(inicio)) 


Inicialmente, armazenamos o timestamp atual e configuramos a semente 
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para a geração de números aleatórios, garantindo que números diferentes se- 
jam gerados a cada execução. 

Em seguida, criamos uma variável chamada controle do tipo 
sync.WaitGroup que utilizaremos para sincronizar a execução das go- 
routines. Antes de disparar cada goroutine, chamamos o método 
controle.Add (1), indicando que uma nova goroutine deverá ser sincro- 
nizada, e então iniciamos sua execução chamando a função executar (). 

Repare que passamos como argumento um ponteiro para a variável 
controle. Como os argumentos em Go são passados como cópias, é im- 
portante que utilizemos um ponteiro neste caso, pois o mesmo WaitGroup 
deve ser utilizado por todas as goroutines. 

Por fim, chamamos o método controle.Wait (), que neste caso irá 
bloquear a execução da função main () até que todas as goroutines tenham 
finalizado. Quando isto acontecer, o método Wait () irá retornar, e então 
imprimiremos o tempo percorrido entre o início e o fim da execução do pro- 
grama. 

Agora, vamos adicionar o código da função executar (): 


func executar(controle *sync.WaitGroup) { 
defer controle.Done() 


duracao := time.Duration(i+rand. Intn(5)) * time.Second 
fmt.Printf ("Dormindo por Ys...in", duracao) 
time.Sleep(duracao) 


Primeiro, garantimos que o método controle.Done () será chamado 
quando a função terminar sua execução, notificando o WaitGroup deste 
fato. Em seguida, criamos um valor do tipo time.Duration baseado 
em um número aleatório entre 1 e 5 segundos. Então chamamos a função 
time.Sleep() para que a goroutine atual durma pelo período especificado. 


Um exemplo da execução deste programa: 


$ go run cap7-sincronizador/sincronizador.go 
Dormindo por 5s... 
Dormindo por 4s... 
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Dormindo por 1s... 
Dormindo por 4s... 
Dormindo por 3s.. 
Finalizado em 5. 0011858375. 


7.8 CONCORRÊNCIA, PARALELISMO E GOMAXPROCS 


Todos os recursos apresentados neste capítulo fazem parte do suporte nativo 
de Go para programas concorrentes. Porém, é importante ressaltar que con- 
corrência não é paralelismo, e nenhum destes recursos fará com que um pro- 
grama execute em paralelo utilizando todos os CPUs disponíveis no ambiente 
de execução. 

Alguns programas, no entanto, realizam operações que exigem um poder 
de processamento maior e podem se beneficiar da utilização dos múltiplos 
cores disponíveis. 

Por padrão, o runtime da linguagem Go executa uma única goroutine em 
um dado momento, mas disponibiliza uma forma de modificar esta configu- 
ração. 

Por exemplo, ao iniciar a execução de um programa, pode-se especificar 
a variável de ambiente GOMAXPROCS: 


$ GOMAXPROCS=2 go run paralelo.go 


É possível também configurar este valor programaticamente através do 
pacote runtime: 


func main() { 
runtime. GOMAXPROCS (runtime . NumCPU()) 


PR sata 


O código anterior instrui o runtime a utilizar todos os cores disponíveis. 


A seguir veremos um exemplo de programa que se beneficia do uso de 
múltiplos cores. 


package main 
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import ( 
"fmt" 
"math" 
"sync" 
"time" 
) 


func calcular(base float64, controle *sync.WaitGroup) 1 
defer controle.Done() 
n := 0.0 


for i := 0; i < 100000000; i++ 1 
n += base / math.Pi * math.Sin(2) 


fmt.Println(n) 


func main() { 
inicio := time.Now() 
var controle sync.WaitGroup 
controle. Add(3) 


go calcular(9.37, &controle) 
go calcular(6.94, &controle) 
go calcular(42.57, &controle) 


controle.Wait () 
fmt.Printf("Finalizado em %s.\n", time.Since(inicio)) 


O código é bastante simples e apenas dispara 3 goroutines que realizam 
algum tipo de cálculo que exige alto uso da CPU. 

Os resultados a seguir foram colhidos em um computador com 4 cores. 
Inicialmente, um exemplo de execução utilizando a configuração padrão do 
runtime: 


$ go run paralelo.go 
2.712037442294368e+08 
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2.0087022191177934e+08 
1.2321391006719112e+09 
Finalizado em 4.515132372s. 


Em seguida, instruímos o runtime a utilizar dois cores: 


$ GOMAXPROCS=2 go run paralelo.go 
2.0087022191177934e+08 
2.712037442294368e+08 
1.2321391006719112e+09 

Finalizado em 2.419171346s. 


Veja que o tempo de execução caiu quase pela metade! Por fim, vamos 
instruir o runtime a utilizar 3 cores. É esperado que esta configuração seja a 
ideal, já que temos exatamente 3 goroutines executando. O resultado: 


$ GOMAXPROCS=3 go run paralelo.go 
2.712037442294368e+08 
2.0087022191177934e+08 
1.2321391006719112e+09 

Finalizado em 2.165083253s. 


Agora tivemos um ganho menor, mas ainda significativo. 

É importante ressaltar que este recurso deve ser utilizado com bastante 
cautela e pode produzir resultados muito diferentes dependendo da natureza 
do programa em questão. É recomendável que cada caso seja estudado com 
cuidado. 


7.9 RECAPITULANDO 


Este capítulo apresentou os principais conceitos de concorrência disponíveis 
em Go, dando um foco especial a goroutines e channels. No entanto, há muito 
a ser explorado sobre esse assunto. 

Programação concorrente é um tema de alta complexidade. O modelo de 
concorrência da linguagem foi criado com o objetivo de tornar a escrita de 
programas concorrentes uma tarefa mais fácil. 

Crie seus próprios programas utilizando os recursos aprendidos, modifi- 
que os exemplos apresentados e pratique bastante. Assim, você absorverá os 
conceitos mais facilmente. 
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Mão na massa: encurtador de 
URLs 


Nosso passeio pelos principais recursos da linguagem Go chegou ao fim. Para 
consolidar todo o conhecimento acumulado até aqui, chegou a hora de colo- 
car a mão na massa e desenvolver uma aplicação real! 

Vamos desenvolver um servidor HTTP que provê uma API (application 
programming interface) para criar URLs curtas e redirecioná-las para as URLs 
originais. Para isso, utilizaremos os recursos do pacote net /http e imple- 
mentaremos um repositório em memória. 


81. Estrutura do projeto Casa do Código 


8.1 ESTRUTURA DO PROJETO 


Até agora, todos os exemplos apresentados definiam um único pacote main. 
Projetos maiores e mais complexos, porém, necessitam de pacotes adicionais 
para organizar melhor o código. 

No capítulo 1.2, aprendemos como configurar uma área de trabalho atra- 
vés da variável de ambiente SGOPATH. Este passo é especialmente importante 
para que projetos que definem múltiplos pacotes possam ser corretamente 
compilados. 

Todo projeto em Go segue uma convenção semelhante: a estrutura de 
diretórios e pacotes é definida de acordo com o caminho do repositório 
onde o código reside. Por exemplo, projetos hospedados no GitHub in- 
cluem github.com/usuario/projeto/nome-do-pacote no caminho 
completo dos pacotes. Veremos a importância desta convenção no capítulo 
9. 

Considerando que o nosso projeto será hospedado em https://github. 
com/caiofilipini/encurtador, a seguinte estrutura de diretórios deverá ser cri- 
adaem SGOPATH/src: 


github. com/caiofilipini/encurtador/ 
servidor.go 
url 
[= repositorio memoria.go 
url.go 


Figura 8.1: Estrutura do projeto 


Vamos começar pela definição do servidor propriamente dito. 


8.2 (CRIANDO O SERVIDOR 


O servidor será definido no arquivo servidor .go e será o ponto de partida 
da nossa aplicação. Neste arquivo, definiremos a função main () que será 
responsável por configurar e iniciar o servidor HTTP. 


Primeiro, vamos definir o pacote main e especificar as dependências: 
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package main 


import ( 
"fmt "n 
n log" 
"net/http" 
"strings" 


"github.com/caiofilipini/encurtador/url" 


Nenhuma grande novidade até aqui, exceto pelo caminho do pacote in- 
terno url. 

Precisamos de uma variável para armazenar a porta onde o serviço irá 
aceitar novas conexões, e também uma variável para representar a URL base 
do serviço. Como elas serão utilizadas em mais de um lugar, vamos criá-las 
no nível do pacote para que sejam acessíveis por todas as funções definidas 
nele: 


var ( 
porta int 
urlBase string 


Agora precisamos inicializá-las. Go disponibiliza um mecanismo padrão 
para inicialização de variáveis e recursos utilizados em um pacote: a função 
init (). Um pacote pode definir várias funções init () diferentes (prática 
comum, caso o código do pacote seja dividido em múltiplos arquivos, mas a 
ordem de chamada é indefinida). No nosso caso, precisamos de uma única: 


func init() 1 
porta = 8888 
urlBase = fmt.Sprintf ("http://localhost:Yd", porta) 


E chegamos finalmente à definição da função main (), onde configura- 
mos as rotas para o nosso servidor HTTP: 
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func main() { 
http. HandleFunc("/api/encurtar", Encurtador) 
http.HandleFunc("/r/", Redirecionador) 


log.Fatal (http.ListenAndServe( 
fmt.Sprintf(":h)d", porta), nil)) 


Definimos duas rotas para o nosso servidor: 


e /api/encurtar: responsável por receber uma URL, criar um identi- 
ficador curto e retornar a URL curta; 


e /r/<id-curto>: responsável por receber um identificador curto e 
redirecionar para a URL original. 


Configuramos as duas rotas utilizando a função http. HandleFunc (). 
Arota /api/encurtar será tratada pela função Encurtador, enquanto a 
função Redirecionador cuidará das requisições recebidas em /r/. 

A seguir veremos em detalhes cada uma destas funções. A implementa- 
ção do pacote interno url será apresentada posteriormente. Por enquanto, 
veremos somente a definição do tipo Url, que será usado nos exemplos a 
seguir: 


type Url struct { 
Id string 
Criacao time.Time 
Destino string 


Este tipo é uma struct simples, contendo um campo para armazenar o 
identificador curto ( Id), a data e hora da criação da URL curta (Criacao), 
ea URL original (Destino). 


8.3 CRIANDO URLS CURTAS 


A função  Encurtador() irá tratar as requisições recebidas em 
/api/encurtar. 
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Como esta função será registrada através do método 
http.HandleFunc (), ela precisa ser do tipo http.HandlerFunc. 
Portanto, sua assinatura é: 


func Encurtador (w http.ResponseWriter, r *http.Request) 


Como estamos implementando uma API sobre HTTP, tentaremos seguir 
o padrão arquitetural REST (Representational State Transfer [1]). Assim, o 
primeiro passo é verificar se estamos recebendo uma requisição do tipo POST 
e, caso contrário, retornaremos um erro HTTP 405 (Method Not Allowed), 
indicando no cabeçalho Allow que este serviço aceita apenas requisições 
com o método POST: 


if r.Method != "POST" 1 
responderCom(w, http.StatusMethodNotAllowed, Headers{ 
"Allow": "POST", 
» 


return 


Para formatar a resposta incluindo o cabeçalho Allow, chama- 
mos uma função utilitária responderCom() que recebe o objeto 
http.ResponseWriter, o código de resposta desejado e um mapa de ca- 
beçalhos do tipo Headers. Este tipo é apenas um type alias para o tipo 
map [string] string e foi criado para tornar o código mais claro. Sua de- 
finição é a seguinte: 


type Headers map [stringlstring 


A função responderCom() itera sobre os cabeçalhos 
recebidos, configurando cada um deles através do método 
http.ResponseWriter.Header().Set () antes de, finalmente, ajustar 
o código de resposta chamando o método WriteHeader (), também 
disponível para objetos do tipo http. ResponseWriter: 


func responderCom( 
w http.ResponseWriter, 
status int, 
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headers Headers, 
y 
for k, v := range headers { 


w.Header().Set(k, v) 
} 


w.WriteHeader (status) 


Continuando o fluxo de execução, caso tenhamos recebido uma requisi- 
ção POST válida, chamamos a função extrairUrl() para ler e retornar a 
URL recebida no corpo da requisição. Esta função é bastante simples: 


func extrairUrl(r *http.Request) string { 
url := make([]byte, r.ContentLength, r.ContentLength) 
r.Body.Read (url) 
return string(url) 


Primeiro, criamos um slice de bytes chamado url, especificando seu 
tamanho inicial como sendo o tamanho do corpo da requisição — presente no 
campo ContentLength do tipo http. Request. Em seguida, utilizamos 
o método Body .Read (), também do tipo http. Request, para ler o con- 
teúdo do corpo da requisição e copiá-lo para o slice ur1. Por fim, retornamos 
uma string criada a partir da conversão dos bytes presentes no slice url. 

Com a URL recebida em mãos, chamamos o método 
Buscar0OuCriarNovaUrl() do nosso próprio pacote url, passando 
como argumento a URL extraída da requisição. Este método retorna três va- 
lores: um objeto do tipo url .Ur1, representando a URL curta recém-criada; 
um valor bool, sendo true caso uma nova URL curta tenha sido criada, 
ou false caso a URL recebida já tenha sido encurtada anteriormente; e um 
error caso a URL recebida seja inválida: 


url, nova, err := url.Buscar0ulriarNovaUrl (extrairUrl(r)) 


Caso tenhamos recebido um erro, retornamos um erro HTTP 400 (Bad 
Request): 


if err != nil { 
responderCom(w, http.StatusBadRequest, nil) 
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return 


Em caso de sucesso, verificamos o valor da variável nova para decidir o 
código de resposta. Responderemos com o código HTTP 201 (Created) caso 
a URL tenha sido criada, ou HTTP 200 (OK), caso a URL já tenha sido en- 
curtada anteriormente: 


var status int 


if nova { 
status = http.StatusCreated 
} else 1 


status = http.Status0OK 
} 


Finalmente, formatamos a URL curta utilizando a urlBase definida na 
inicialização do pacote e apontando para a rota /r/, e então respondemos 
com o código decidido anteriormente (201 ou 200) e a URL curta no cabeça- 
lho Location: 


urlCurta := fmt.Sprintf("hs/r/hs", urlBase, url.Id) 
responderCom(w, status, Headers("Location": urlCurta)) 


Para demonstrar alguns exemplos de requisições para o nosso servidor, a 
partir de agora utilizaremos uma ferramenta chamada CURL. Se você é usuá- 
rio Linux ou Mac OS, provavelmente já possui esta ferramenta instalada por 
padrão. Caso contrário, verifique as instruções de instalação para o seu sis- 
tema operacional em http://curl.haxx.se/download.html. 

Utilizaremos duas opções do comando curl: -v para visualizarmos 
todos os cabeçalhos e o conteúdo da requisição e da resposta; e -d, que é 
utilizada para fazer uma requisição do tipo POST, sendo que a string espe- 
cificada será enviada no corpo desta requisição. Para facilitar a visualização, 
algumas linhas produzidas pelo comando serão omitidas em todos os exem- 
plos de requisições. 

A seguir, veremos um exemplo de requisição para encurtar uma URL 
nova: 
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$ 


curl -v http://localhost :8888/api/encurtar N 


-d "http://casadocodigo.com.br/products/livro-vraptor" 


AN MN à RR hA N N E NE N 


POST /api/encurtar HTTP/1.1 

User-Agent: curl/7.30.0 

Host: localhost :8888 

Accept: */* 

Content-Length: 64 

Content-Type: application/x-www-form-urlencoded 


HTTP/1.1 201 Created 

Location: http://localhost :8888/r/oZYm9 
Date: Tue, 03 Jun 2014 21:45:41 GMT 
Content-Length: 0 

Content-Type: text/plain; charset=utf-8 


Repare na URL curta retornada no cabeçalho Location. 


Agora, se repetirmos a mesma requisição, receberemos uma resposta com 


código 200 em vez do 201, conforme esperado: 


$ 


curl -v http://localhost :8888/api/encurtar \ 


-d "http://casadocodigo.com.br/products/livro-vraptor" 


A N AR A A A NO OO O V NE N 


POST /api/encurtar HTTP/1.1 

User-Agent: curl/7.30.0 

Host: localhost :8888 

Accept: */* 

Content-Length: 64 

Content-Type: application/x-www-form-urlencoded 


HTTP/1.1 200 OK 

Location: http://localhost :8888/r/oZYm9 
Date: Tue, 03 Jun 2014 21:48:24 GMT 
Content-Length: 0 

Content-Type: text/plain; charset=utf-8 
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8.4 REDIRECIONANDO PARA AS URLS ORIGINAIS 


Analisando a URL curta retornada pelo exemplo anterior, percebemos 
que ela aponta para a rota /r/, que foi registrada para ser tratada pela 
função Redirecionador(). Esta função também deve ser do tipo 
http.HandlerFunc e, portanto, deve seguir a mesma assinatura: 


func Redirecionador(w http.ResponseWriter, r *http.Request) 


Apesar de o mecanismo de redirecionamento ser o coração de um serviço 
encurtador de URLs, não precisamos de muito código para realizar esta tarefa. 
O padrão das URLs curtas geradas pelo serviço anterior é /r/<id-curto>. 
No caso da requisição de exemplo, geramos a URL curta /r/oZYm9; o iden- 
tificador curto é oZYm9. 

Com isso em mente, o primeiro passo para redirecionar para a 
URL original é extrair seu identificador do caminho da URL curta 
(obtido em http.Request.URL.Path). Podemos chamar a função 
strings.Split (), que separa uma string em várias partes baseado em um 
caractere especificado e retorna as partes separadas em um slice. Vamos uti- 
lizar "/" como caractere separador, armazenar o slice retornado na variável 
caminho, e então assumir que o último elemento do slice contém o identifi- 
cador esperado: 


caminho := strings.Split(r.URL.Path, "/") 
id := caminho[len(caminho)-1] 


Agora precisamos verificar se este identificador corresponde a uma URL 
armazenada. Para isso, vamos utilizar a função Buscar () do nosso pacote 
url, que recebe um identificador e retorna a URL encontrada ou nil, caso a 
mesma não exista. Desta forma, verificamos se o retorno é diferente de nil. 
Em caso positivo, retornamos uma resposta HTTP 301 (Moved Permanently) 
que irá redirecionar para a URL original (url.Destino); caso o identifi- 
cador não corresponda a uma URL encurtada anteriormente, simplesmente 
retornamos um erro HTTP 404 (Not Found): 


if url := url.Buscar(id); url != nil 1 
http.Redirect(w, r, url.Destino, 
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http.StatusMovedPermanently) 
+ else { 
http.NotFound(w, r) 


Repare que, como em nenhum dos casos precisamos responder com ca- 
beçalhos especiais, utilizamos as funções predefinidas http.Redirect () 
e http.NotFound () para formatar as respostas. Outro detalhe importante 
é a criação da variável url no bloco if; isto faz com que seu escopo seja 
limitado somente ao próprio bloco e é uma prática bastante comum quando 
a variável não será utilizada em nenhum outro lugar. 

Utilizando a URL encurtada anteriormente, podemos fazer uma requisi- 
ção GET e visualizar a resposta: 


$ curl -v http://localhost:8888/r/oZYm9 
> GET /r/oZYm9 HTTP/1.1 
> User-Agent: curl/7.30.0 
> Host: localhost :8888 
> Accept: */* 
> 
< HTTP/1.1 301 Moved Permanently 
< Location: http://casadocodigo.com.br/...programador-apaixonado 
< Date: Tue, 03 Jun 2014 22:15:40 GMT 
< Content-Length: 99 
< Content-Type: text/html; charset=utf-8 
< 
Caso a URL desejada não exista, receberemos um erro HTTP 404, como 
no exemplo a seguir: 


curl -v http://localhost:8888/r/naoexiste 
GET /r/naoexiste HTTP/1.1 

User-Agent: curl/7.30.0 

Host: localhost :8888 

Accept: */* 


HTTP/1.1 404 Not Found 
Content-Type: text/plain; charset=utf-8 
Date: Tue, 03 Jun 2014 22:17:02 GMT 


A A NV MP NS y 
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< Content-Length: 19 
< 


8.5 APRESENTANDO O PACOTE URL 


Até aqui, o pacote interno url foi apresentado mais ou menos como uma 
caixa preta. Interagimos com o tipo url .Url eas funções url.Buscar (), 
url.BuscarOuCriarNovaUrl(), url.ConfigurarRepositorio() e 
url.NovoRepositorioMemoria(). 

Agora veremos em detalhes cada um destes elementos. 

Criar um pacote é a melhor forma de separar - física e logicamente — cer- 
tos elementos em uma aplicação Go. No pacote ur1, definimos toda a lógica 
de criação e armazenamento das URLs curtas, sendo que apenas uma parte 
destas funcionalidades precisa ser exposta. O servidor não precisa conhecer 
detalhes de como tudo funciona; precisa apenas conhecer a interface pública 
com a qual ele deve interagir para criar e redirecionar URLs. 

Todos os exemplos apresentados até aqui definiam apenas o pacote main. 
Para criar um pacote diferente, basta atribuir a ele um outro nome. Por isso, 
o arquivo url/url.go começa com a seguinte declaração: 


package url 


Todo o código definido dentro deste arquivo será compilado em um pa- 
cote chamado github. com/caiofilipini/encurtador/url,eapenas 
os elementos cujos nomes iniciarem com uma letra maiúscula serão visíveis 
por outros pacotes. 

O pacote url, por sua vez, depende de alguns outros pacotes: 


import ( 
"math/rand" 
"net/url" 
"time" 

) 


Além das dependências, nosso pacote também define algumas constantes 
utilizadas internamente (note que seus nomes iniciam com letras minúscu- 
las): 
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const ( 

tamanho = 5 

simbolos = "abcdefghijklmnopgr...STUVWXYZ1234567890 -+" 
) 


A constante tamanho define o tamanho do identificador curto que de- 
verá ser gerado. Já a constante simbolos lista todos os caracteres permitidos 
em um identificador; veremos em breve como eles são gerados. 

Para inicializar suas dependências, um pacote pode definir uma função 
init (), como a que foi apresentada no arquivo servidor.go. O pacote 
url também define sua própria função de inicialização; neste caso, ela é uti- 
lizada apenas para configurar a semente para geração de números aleatórios: 


func init(O) { 
rand.Seed(time.Now().UnixNano()) 


O pacote url define também alguns tipos, como o já conhecido tipo 
Url: 


type Url struct 1 
Id string 
Criacao time. Time 
Destino string 


8.6 ESPECIFICANDO A IMPLEMENTAÇÃO DO REPOSI- 
TÓRIO 


Para padronizar a implementação do repositório onde as URLs serão arma- 
zenadas, definimos também uma interface chamada Repositorio: 


type Repositorio interface { 
IdExiste(id string) bool 
BuscarPorId(id string) *Url 
BuscarPorUrl(url string) +*Url 
Salvar(url Url) error 
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O objetivo desta interface é especificar todas as operações que um repo- 
sitório de URLs deverá ser capaz de implementar. Neste exercício, imple- 
mentaremos um repositório em memória. Porém, poderíamos substituir esta 
implementação por um banco de dados relacional, por exemplo, desde que o 
contrato definido pela interface Repositorio fosse atendido. Desta forma, 
precisaríamos alterar apenas a linha que configura o repositório a ser utilizado 
no arquivo servidor.go. 

Como a implementação concreta do repositório é configurada ex- 
ternamente, precisamos definir uma função que seja capaz de registrar 
esta configuração. Para isso, definimos primeiramente a variável repo 
para armazenar o repositório propriamente dito, e fornecemos a função 


ConfigurarRepositorio(): 


var repo Repositorio 


func ConfigurarRepositorio(r Repositorio) { 
repo = r 


} 


Repare que o tipo do argumento r é definido como Repositorio, que é 
a interface definida anteriormente. Desta forma, não importa qual é a imple- 
mentação configurada, deste que a interface seja obedecida; o próprio compi- 
lador garante esta restrição. Repare também que a única forma de configurar 
o repositório é através desta função, já que a variável repo não é visível fora 
do pacote. 

A implementação do repositório em memória será apresentada posteri- 
ormente. 


8.7 CRIANDO IDENTIFICADORES CURTOS 


Uma das funcionalidades principais de um serviço encurtador de URLs é a 
capacidade de gerar identificadores curtos. Para expor esta funcionalidade, o 
pacote url implementa a função BuscarOuCriarNovaUrl (). Sua assi- 
natura é a seguinte: 


func BuscarOuCriarNovaUrl (destino string) ( 
u *string, 
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nova bool, 
err error, 


Recapitulando, esta função recebe a URL original como argumento e re- 
torna três valores: um ponteiro para um objeto do tipo Ur1, representando a 
URL curta recém-criada; um valor bool, sendo true caso uma nova URL 
curta tenha sido criada, ou false caso a URL recebida já tenha sido encur- 
tada anteriormente; e um error caso a URL recebida seja inválida. 

O primeiro passo é verificar se a URL já foi encurtada anteriormente, evi- 
tando duplicações. Para isso, chamamos o método repo.BuscarPorUrl () 
passando a URL destino como argumento. Caso uma URL tenha sido en- 
contrada, ela será imediatamente retornada, acompanhada do valor false, 
indicando que a URL já existia, e nil como erro: 


if u = repo.BuscarPorUrl(destino); u != nil 1 
return u, false, nil 


Caso a URL especificada ainda não tenha sido encurtada, precisamos ter 
certeza de que recebemos uma URL válida para evitar problemas de redireci- 
onamento. A biblioteca padrão fornece um pacote chamado net /url, res- 
ponsável por identificar e manipular URLs de todos os tipos. Este pacote de- 
fine uma função ParseRequestURI (), que trata especificamente de URLs 
HTTP, e retorna um erro caso a URL especificada não seja válida — exata- 
mente o que precisamos fazer. Caso um erro tenha sido encontrado, ele será 
retornado: 


if _, err = url.ParseRequestURI (destino); err != nil 1 
return nil, false, err 


Se chegamos até aqui, temos a certeza de que a URL recebida é válida e não 
foi encurtada anteriormente. Portanto, criamos um novo objeto Url e o po- 
pulamos com um identificador curto, uma data de criação (a data/hora atual) 
e a URL destino. Em seguida, chamamos o método repo.Salvar() para 
persisti-lo no repositório e retornamos o endereço do objeto recém-criado e 
o valor true, indicando a criação de uma nova URL: 
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url := Url(gerarId(), time.Now(), destino) 
repo.Salvar (url) 
return &url, true, nil 


Agora vamos acompanhar passo a passo o algoritmo para gerar um novo 
identificador curto, implementado pela função gerarId(). A ideia geral é 
extrair cinco caracteres aleatórios (como definido pela constante tamanho) 
da lista de caracteres permitidos (definida na constante simbolos) e juntá- 
los em uma string - o identificador; caso ele já exista no repositório, repe- 
timos o processo até que um identificador totalmente novo seja gerado: 


func gerarId() string { 


novold := func() string { 
id := make([]byte, tamanho, tamanho) 
for i := range id 1 
id[i] = simbolos [rand. Intn(len(simbolos))] 
} 
return string(id) 
+ 
for 1 
if id := novold(); !repo.IdExiste(id) 1 
return id 
} 
} 


Como cada caractere da string simbolos é acessado individual- 
mente, eles são representados como bytes, por isso a variável id foi definida 
como um slice de bytes, que é convertido para uma string ( string (id) ) 
antes de ser retornado. 

Outro detalhe interessante é que, para facilitar a repetição do processo 
caso um identificador já exista, criamos uma função anônima e a armazena- 
mos na variável novoId. Assim, podemos chamá-la mais de uma vez em um 
laço infinito, que é quebrado quando a palavra-chave return força o retorno 
da função assim que um identificador totalmente novo é gerado. 

Para finalizar, como o repositório repo é um objeto visível apenas ao 
pacote url, precisamos expor a funcionalidade de buscar uma URL pelo seu 
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identificador curto, da qual o redirecionador depende. Para isso, definimos a 
função Buscar (), que apenas delega a busca ao próprio repositório: 


func Buscar(id string) *Url 1 
return repo.BuscarPorId(id) 


k 


8.8 IMPLEMENTANDO O REPOSITÓRIO EM MEMÓRIA 


O repositório em memória, parte do pacote url, será definido no arquivo 
url/repositorio memoria.go, que também começa com a definição do 
pacote: 


package url 


Na prática, este repositório nada mais é do que um mapa cujas chaves são 
os identificadores curtos, e os valores são ponteiros para os objetos do tipo 
Url. Em outras palavras, um map [string] *Url: 


type repositorioMemoria struct 1 
urls map [string] *Url 


} 


Repare que o nome do tipo definido é repositorioMemoria, inici- 
ando com uma letra minúscula. Isto garante que a implementação não será 
conhecida fora do próprio pacote, assegurando o encapsulamento. 

No entanto, precisamos fornecer uma maneira de criar objetos deste tipo. 
Este é o objetivo da função NovoRepositorioMemoria (), utilizada pelo 
servidor para criar e configurar um repositório no início da execução do pro- 
grama: 


func NovoRepositorioMemoria() *repositorioMemoria { 
return &repositorioMemoria(make (map [string] *Url)+ 


Como a implementação é baseada em um mapa, seus métodos tiram pro- 
veito das funcionalidades básicas dos mapas em Go. 

Por exemplo, o método IdExiste () simplesmente verifica se o identi- 
ficador especificado é uma chave que existe no mapa: 
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func (r *repositorioMemoria) IdExiste(id string) bool { 
—, existe := r.urls[id] 
return existe 


De maneira semelhante, o método BuscarPorId() retorna o valor ar- 
mazenado sob o identificador recebido, que será nil caso a chave não esteja 
presente no mapa: 


func (r *repositorioMemoria) BuscarPorId(id string) *Url 1 
return r.urls [id] 


} 


Já o método BuscarPorUrl () precisa iterar pelos valores armazenados 
no mapa e compará-los à URL recebida como argumento, retornando o objeto 
correspondente caso encontre a URL desejada, ou nil caso contrário: 


func (r *repositorioMemoria) BuscarPorUrl (url string) *Url 1 


for _, u := range r.urls { 
if u.Destino == url 1 
return u 
} 
J 


return nil 


Por fim, o método Salvar () armazena uma nova entrada no mapa uti- 
lizando o identificador da Url como chave, e o endereço do próprio objeto 
como valor: 


func (r *repositorioMemoria) Salvar(url Url) error 1 
r.urls [url. Id] = &url 
return nil 


Como esta operação em um mapa não produz nenhum erro (a não ser 
que não exista mais memória disponível para armazenar este valor), o método 
Salvar () simplesmente retorna nil. 

Missão cumprida! No próximo capítulo, veremos como executar, compi- 
lar e instalar o projeto localmente. 
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Compilando e executando o 
projeto 


Go é uma linguagem compilada, assim como C ou C++. Isto significa que não 
existe uma linguagem intermediária nem uma máquina virtual envolvidas no 
momento da execução de um programa. Código Go é compilado diretamente 
para a linguagem da máquina; o artefato gerado pelo processo de compilação 
é um arquivo binário executável, compatível apenas com o sistema operacio- 
nal alvo da compilação. 

Todos os exemplos apresentados até aqui foram executados através do 
comando go run. 

Por exemplo, agora que temos um código funcional para o servidor de 
URLs curtas, podemos executá-lo utilizando o mesmo comando. Primeiro, 
certifique-se de que você está no diretório que contém o código do pro- 
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jeto ( SGOPATH/src/github. com/caiofilipini/encurtador), e en- 
tão execute o comando a seguir: 


$ go run servidor.go 


Se o programa foi compilado com sucesso e o servidor foi capaz de abrir 
um socket na porta 8888, nenhuma saída será gerada e o processo ficará blo- 
queado. Para ter certeza de que o servidor está no ar, podemos, em uma outra 
instância do terminal, utilizar o seguinte comando: 


$ telnet localhost 8888 
Trying 127.0.0.1... 
Connected to localhost. 
Escape character is ?"]”. 


Se você obteve uma saída similar ao executar o comando telnet, signi- 
fica que o servidor está no ar e fomos capazes de nos conectar a ele. 


91 ENTENDENDO O PROCESSO DE COMPILAÇÃO 


O comando go run executa o processo completo de compilação sem que 
você precise se preocupar com o que está acontecendo. Por isso, é um utilitá- 
rio muito importante durante o desenvolvimento de programas em Go. 

Na prática, este comando realiza três operações distintas sequencial- 
mente: compila os arquivos-fonte em arquivos-objeto; realiza o processo de 
linkedição dos arquivos-objeto, gerando (em um diretório temporário) um 
executável binário; executa o binário gerado. Este fluxo é bastante similar ao 
utilizado para compilar programas em C e C++. 

As ferramentas distribuídas com a linguagem Go fornecem comandos 
distintos para compilação e linkedição. Estes comandos possuem nomes di- 
ferentes de acordo com a arquitetura do processador alvo da compilação. Por 
exemplo, caso a arquitetura alvo seja amd64, precisamos utilizar o comando 
6g para compilar os arquivos-fonte, e em seguida o comando 61 para rea- 
lizar a linkedição; de maneira análoga, para realizar o mesmo procedimento 
para processadores com arquitetura x86, os comandos são 8ge 81, respec- 
tivamente. Essa nomenclatura é herança das ferramentas de compilação do 
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sistema operacional Plan 9, que foram a base para a criação das ferramentas 
disponíveis em Go. 

É importante conhecer estes detalhes para entender o que acontece 
quando compilamos e executamos um programa em Go. No entanto, é pos- 
sível realizar todo este processo com um único comando: go build. 

Podemos gerar um executável do nosso serviço encurtador de URLs 
executando este comando. Como o código está hospedado em um di- 
retório chamado encurtador, o arquivo executável será gerado com o 
mesmo nome. Assumindo que ainda temos um terminal aberto no dire- 
tório SGOPATH/src/github.com/caiofilipini/encurtador, pode- 
mos gerar um executável para o nosso projeto e executá-lo da seguinte forma: 


$ go build 


$ ls -l ./encurtador 
-rwxr-xr-x 1 caio xxxxx 6.6M Jun 5 22:35 ./encurtador 


$ ./encurtador 


Estes passos reproduzem exatamente o processo realizado quando utili- 
zamos o comando go run, com a diferença de que o executável gerado não é 
descartado quando sua execução é finalizada. O comando 1s foi adicionado 
apenas para facilitar a visualização. 


9.2 INSTALANDO O EXECUTÁVEL NO SISTEMA 


Go também fornece um comando chamado go install, que executa o 
mesmo processo de compilação apresentado anteriormente, porém faz a ins- 
talação do programa no ambiente Go local, conforme configurado na variável 
de ambiente $GOPATH. 

Por exemplo, considerando que estamos compilando o projeto em um 
Linux 64 bits, quando executamos go install no diretório encurtador, 
dois artefatos são gerados e instalados: 


. o pacote url é compilado e disponibilizado em 
SGOPATH/pkg/linux amd64/github.com/.../encurtador/url.a 
para que possa ser utilizado por outros programas; 
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e o executável encurtador, compatível apenas com Linux 64 bits, é 
gerado no diretório SGOPATH/bin. 


Assim, caso o diretório SGOPATH/bin tenha sido adicionado à variável 
de ambiente SPATH, é possível executar o servidor de URLs curtas de qual- 
quer lugar do seu sistema. 


9.3 APRENDENDO MAIS 


O processo de compilação de programas em Go é bastante prático, porém 
apenas o básico foi apresentado neste capítulo. É possível, por exemplo, gerar 
executáveis compatíveis com Windows em um computador com Mac OS ou 
Linux e vice-versa. 

Para finalizar, vamos fazer um pequeno exercício. O comando go build 
possui uma opção -x que mostra, passo a passo, todo o processo de compi- 
lação. Execute este comando no seu computador, analise os resultados e tente 
entender o que acontece em cada um dos passos. 


$ go build -x 


A documentação completa do comando go pode ser encontrada no en- 
dereço http://golang.org/cmd/go/. 
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Colhendo estatísticas 


Sistemas encurtadores de URLs foram criados para facilitar o compartilha- 
mento de URLs. Isto se tornou especialmente importante após a populari- 
zação de serviços como o Twitter, onde o número de caracteres é limitado, 
impossibilitando o compartilhamento de URLs muito grandes. 

Hoje em dia, os serviços encurtadores de URLs mais populares provêm 
também uma série de funcionalidades complementares, sendo a coleta e vi- 
sualização de estatísticas uma das mais importantes. 

Vamos criar um mecanismo para coletar estatísticas a respeito das URLs 
curtas criadas pelo nosso próprio serviço: implementaremos uma simples 
contagem de quantas vezes cada URL foi acessada. 


10.1. Realizando a contagem no repositório Casa do Código 


10.1 REALIZANDO A CONTAGEM NO REPOSITÓRIO 


Existem várias formas de implementar a contagem de acessos. Como já im- 
plementamos o repositório em memória utilizando um mapa, podemos rea- 
proveitar a ideia e utilizar também um mapa para armazenar a contagem. 
Para facilitar a implementação, vamos adicionar um método à interface 
Repositorio já existente, definida no arquivo url/url.go: 


type Repositorio interface { 
FE Sw 
RegistrarClick(id string) 


Precisamos também alterar o tipo repositorioMemoria para imple- 
mentar o novo método. Mas antes de adicionar a implementação, preci- 
samos criar um novo mapa para armazenar a contagem de acessos. Para 
isso, vamos adicioná-lo à struct repositorioMemoria no arquivo 


url/repositorio memoria.go: 


type repositorioMemoria struct { 
PP sua 


clicks map[string]int 


Como adicionamos um novo mapa, precisamos garantir que ele será 
inicializado na criação do objeto. Portanto, vamos alterar a função 
NovoRepositorioMemoria () para inicializá-lo: 


func NovoRepositorioMemoria() +repositorioMemoria ( 
return &repositorioMemoria( 
make (map [string]+Url), 
make (map [stringlint), 


Para facilitar a leitura, quebramos a inicialização em várias linhas. 

Finalmente, podemos adicionar a implementação do método 
RegistrarClick() ao tipo  repositorioMemoria da seguinte 
forma: 


146 


Casa do Código Capítulo 10. Colhendo estatísticas 


func (r *repositorioMemoria) RegistrarClick(id string) { 
r.clicks[id] += 1 
P 


Como o valor armazenado sob uma chave stringéum int, que possui 
0 como valor padrão, não precisamos verificar se já existe algum valor arma- 
zenado para a chave id recebida; quando o primeiro acesso for registrado, 
a chamada r.clicks[id] retornará 0 e, portanto, a expressão completa 
r.clicks[id] += 1 resultará no valor 1 sendo armazenado para o id 
recebido. 

Para que possamos chamá-lo de fora do pacote url, precisamos ex- 
por este método. Assim, podemos registrar as requisições recebidas pela 
função Redirecionador () definida no arquivo servidor.go. Para 
isso, vamos alterar o arquivo url/url.go e criar uma nova função 
RegistrarClick(). Ela irá apenas delegar a chamada ao repositório, de 
maneira semelhante à forma como implementamos a função Buscar (): 


func RegistrarClick(id string) 1 
repo.RegistrarClick(id) 


Ágora o repositório está preparado para realizar a contagem de acessos. 


10.2 REGISTRANDO OS ACESSOS NO SERVIDOR 


Para registrar cada acesso, precisamos alterar o servidor. go para chamar 
a função url.RegistrarClick() a cada requisição recebida. 

Como no momento registraremos apenas a quantidade de acessos, po- 
deríamos simplesmente alterar a função Redirecionador () e adicionar a 
chamada imediatamente após a chamada à http. Redirect (), resultando 
no seguinte código: 


func Redirecionador(w http.ResponseWriter, r *http.Request) 1 
PE me 


if url := url.Buscar(id); url != nil 1 
http.Redirect(w, r, url.Destino, 
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http.StatusMovedPermanently) 


url.RegistrarClick(id) 


4 


No entanto, normalmente este tipo de redirecionamento deve ser tratado 
da maneira mais rápida possível. Caso desejássemos registrar outras métri- 
cas no futuro, precisaríamos adicionar diversas outras chamadas a diferentes 
funções ou métodos, atrasando ainda mais a resposta e piorando muito a ex- 
periência do usuário. 

Este tipo de problema é muito comum em servidores HTTP. Uma téc- 
nica bastante utilizada para resolvê-lo é processar apenas o necessário no mo- 
mento da requisição, e utilizar algum mecanismo para realizar o restante do 
trabalho em um momento posterior. 

Implementar este tipo de solução em Go é trivial: vamos utilizar uma 
goroutine! 

Precisamos de um canal para realizar a comunicação com a goroutine. 
Como tudo o que precisamos para registrar o acesso é do identificador da 
URL curta -uma string -, criaremos um canal capaz de trafegar strings. 
Este canal deve ser acessível pela própria goroutine, mas também pela fun- 
ção Redirecionador (). Podemos declará-lo como uma variável global, 
da mesma forma que fizemos com as variáveis porta e urlBase: 


var ( 
porta int 
urlBase string 
stats chan string 


Vamos criar uma função que, utilizando o operador range, bloqueia a 
execução até que alguma mensagem seja recebida no canal, e então registra 
o acesso no repositório e imprime uma linha na saída padrão indicando o 
sucesso da operação: 
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func registrarEstatisticas(ids <-chan string) { 
for id := range ids 1 
url.RegistrarClick(id) 
fmt.Printf("Click registrado com sucesso para %s.\n", id) 


Para que possamos registrar as estatísticas para cada redirecionamento, 
precisamos disparar a goroutine assim que o servidor for iniciado. Vamos 
alterar a função main () para criar o canal e imediatamente iniciar uma go- 
routine executando a função registrarEstatisticas(): 


func main() { 
stats = make(chan string) 
defer close(stats) 
go registrarEstatisticas(stats) 


PE tê ga 


Repare que, assim que o canal foi criado, garantimos que ele será fe- 
chado ao final da execução da função main () através da chamada defer 
close (stats). 

Para finalizar, vamos alterar a função Redirecionador () para enviar 
o identificador da URL acessada para o canal stats, desencadeando o pro- 
cesso que irá registrar este acesso: 


func Redirecionador(w http.ResponseWriter, r *http.Request) { 
Pb. agi 


if url := url.Buscar(id); url != nil 1 
http.Redirect(w, r, url.Destino, 
http.StatusMovedPermanently) 


stats <- id 


H t: 
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Agora já temos todo o código necessário para registrar as estatísticas de 
acesso! 


Vamos iniciar o servidor executando a nova versão do código: 


$ go run servidor.go 


Em uma outra janela do terminal, vamos criar uma nova URL curta: 


$ curl -v "http://localhost:8888/api/encurtar" \ 

-d "http://casadocodigo.com.br/products/livro-jogos-android" 
> POST /api/encurtar HTTP/1.1 

User-Agent: curl/7.30.0 

Host: localhost :8888 

Accept: */* 

Content-Length: 55 

Content-Type: application/x-www-form-urlencoded 


HTTP/1.1 201 Created 

Location: http://localhost :8888/r/9a0Ff 
Date: Sat, 07 Jun 2014 19:09:12 GMT 
Content-Length: 0 

Content-Type: text/plain; charset=utf-8 


AAN AN N OA O ME N YN 


A partir de agora, cada requisição à URL curta deverá incrementar o con- 
tador. Vamos realizar algumas requisições e verificar se o registro está sendo 
feito: 


$ curl http://localhost :8888/r/9a0Ff 
$ curl http://localhost :8888/r/9a0Ff 
$ curl http://localhost :8888/r/9a0Ff 


Para facilitar a visualização, os detalhes destas requisições foram omitidos 
por completo. 

Para cada uma destas requisições, na janela onde o servidor foi iniciado, 
podemos ver uma linha relacionada indicando o registro do acesso: 


Click registrado com sucesso para 9a0Ff. 
Click registrado com sucesso para 9a0Ff. 
Click registrado com sucesso para 9a0Ff. 
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Mas como saber se estamos de fato registrando cada acesso? 

Precisamos fornecer alguma maneira de visualizar as estatísticas colhi- 
das. Idealmente, uma API deste tipo deve prover estes dados de uma maneira 
flexível, permitindo que o cliente decida a melhor forma de apresentá-los. 

Como estamos desenvolvendo uma API sobre HTTP, uma forma simples 
de atingir este resultado é retornar os dados no formato JSON (JavaScript 
Object Notation). 


10.3 SERIALIZANDO JSON 


Para serializar objetos no formato JSON, Go fornece o pacote 
encoding/json. Basicamente, quase qualquer tipo válido em Go 
pode ser serializado, incluindo maps e structs, com a exceção de canais, 
funções e o tipo complex (que representa números complexos). 

Serializar uma struct utilizando o pacote encoding/json é uma ta- 
refa trivial; basta chamar a função json.Marshal (), que possui a seguinte 
assinatura: 


func Marshal(v interface()) ([]byte, error) 


Repare que, para ser capaz de serializar qualquer tipo, a função 
Marshal () recebe um argumento do tipo interface(), denominado v. 
Esta função converte todos os campos públicos da struct v em suas repre- 
sentações JSON e retorna um slice de bytes contendo o JSON serializado, 
e um error, que será nil caso a serialização tenha sido realizada com su- 
cesso. 

Por exemplo, para serializar um valor do tipo url. Url, podemos utilizar 
o seguinte trecho de código: 


url := Url{ 
"9a0Ff", 
time.Now(), 
"http://casadocodigo.com.br/products/livro-jogos-android", 


json, err := json.Marshal (url) 
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if err == nil { 
fmt.Println(string(json)) 


Assim, o objeto ur1 seria convertido para a seguinte representação JSON 
(a formatação foi adicionada para facilitar a visualização): 


í 
"Id":"9a0Ff", 
"Criacao" :"2009-11-10T23:00:00Z", 
"Destino": 
"http://casadocodigo.com.br/products/livro-jogos-android" 
E; 


Simples, não? 

O único problema com o exemplo anterior é o nome dos campos - como 
apenas os campos públicos são serializados, seus nomes são refletidos no re- 
sultado gerado e começam com letras maiúsculas; dificilmente encontrare- 
mos uma API retornando valores JSON desta forma. 

Felizmente, Go provê uma solução para este problema: marcadores de 
structs (ou struct tags). Podemos controlar a forma como os campos de 
uma struct serão serializados através da utilização destes marcadores. 

Por exemplo, para instruir o método json.Marshal () a serializar os 
campos da struct Url com nomes começando em letras minúsculas, pre- 
cisamos adicionar a ela os seguintes marcadores: 


type Url struct { 


Id string e a aia 
Criacao time.Time "json:"criacao"” 
Destino string “json:"destino"” 


Desta forma, executando o mesmo trecho de código apresentado anteri- 
ormente, obteríamos como resultado o JSON: 


f 


"id":"9a0Ff", 
"criacao":"2009-11-10T23:00:00Z", 
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"destino": 
"http: //casadocodigo.com.br/products/livro-jogos-android" 


Utilizaremos marcadores deste tipo para serializar as estatísticas de acesso 
das URLs. 


10.4 VISUALIZANDO AS ESTATÍSTICAS COMO JSON 


Agora que já sabemos o básico sobre serialização JSON em Go, vamos adici- 
onar uma nova rota ao nosso servidor para retornar as estatísticas de acesso 
de uma URL neste formato. 

Antes de mais nada, precisamos definir uma nova struct para repre- 
sentar as estatísticas, já incluindo os marcadores para converter os nomes dos 
campos para letras minúsculas. Vamos adicionar a definição deste tipo ao 
arquivo url/url.go: 


type Stats struct { 
Url *Url “json:"url"* 
Clicks int “json:"clicks"” 


A struct Stats define dois campos: uma referência à Url correspon- 
dente e um valor int que contém a quantidade de acessos a esta Url. 


Precisamos também adicionar os marcadores à struct Url, conforme 
o exemplo anterior: 


type Url struct 1 


Id string “json: "id" 
Criacao time.Time “ json:"criacao"” 
Destino string “json:"destino"” 


Para poder retornar o número de acessos armazenado para uma determi- 
nada URL, precisamos adicionar um método à interface Repositorio: 


type Repositorio interface { 


fita as 
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BuscarClicks(id string) int 


Também precisamos adicionar a implementação deste método ao arquivo 
url/repositorio memoria.go: 


func (r *repositorioMemoria) BuscarClicks(id string) int 1 
return r.clicks[id] 


} 


Este método retornará a quantidade de acessos registrados para a URL 
identificada por id. Caso nenhum acesso tenha sido registrado para esta 
URL, a expressão r.clicks [id] retornará 0 -o valor padrão do tipo int. 

Para criar uma interface mais natural, vamos agora adicionar um método 
à struct Url para retornar as estatísticas referentes a uma URL. Primeiro, 
obtemos o número de acessos registrados para esta URL chamando o recém- 
criado método repo.BuscarClicks (); depois, criamos um novo objeto 
Stats, associando a Url e injetando o número de acessos: 


func (u *Url) Stats() *Stats { 
clicks := repo.BuscarClicks(u. Id) 
return &Stats(u, clicks} 


Agora precisamos criar uma nova rota ao servidor.go para retornar 
o JSON contendo as estatísticas de uma determinada URL. Primeiro, vamos 
adicionar a nova rota à configuração do servidor na função main (), antes 
da chamada à http.ListenAndServe (): 


func main() { 


E ses 
http.HandleFunc("/api/stats/", Visualizador) 


DO aia 


A função Visualizador () é muito similar à Redirecionador (), 
portanto, vamos direto à implementação: 
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func Visualizador(w http.ResponseWriter, r *http.Request) { 
caminho := strings.Split(r.URL.Path, "/") 
id := caminho [len(caminho)-1] 


if url := url.Buscar(id); url != nil 1 


json, err := json.Marshal (url.Stats()) 


if err != nil 1 
w.WriteHeader (http. StatusInternalServerError) 
return 


} 


responderComJSON(w, string(json)) 
} else { 
http.NotFound(w, r) 


Começamos extraindo o identificador da URL do caminho da requisição, 
da mesma forma que fizemos na função Redirecionador (). Em seguida, 
chamamos a função url.Buscar () para obter os dados da URL. Se a URL 
for encontrada, utilizamos a função json.Marshal () para serializar o re- 
sultado da chamada url.Stats() (i.e. um valor do tipo url. stats). 

Caso um erro ocorra durante a serialização, interrompemos o processa- 
mento e retornamos um erro HTTP 500. 

Já em caso de sucesso, convertemos o slice json em uma stringe 
chamamos a função responderComJSON () para formatar a resposta. 

Esta função simplesmente chama a função responderCom(), configu- 
rando o valor application/json para o cabeçalho Content-Type e es- 
crevendo o JSON recebido no corpo da resposta: 


func responderComJSON(w http.ResponseWriter, resposta string) { 
responderCom(w, http.StatusDK, Headerst 
"Content-Type": "application/json", 
H} 
fmt .Fprintf (w, resposta) 
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Por fim, se o identificador recebido não corresponder a uma URL curta 
existente, retornamos um erro HTTP 404. 

O último passo necessário para completar esta funcionalidade é criar al- 
guma ligação entre a URL criada e suas estatísticas. Em uma API RESTful, 
quando um recurso é criado, a resposta à requisição que o criou deve in- 
cluir de alguma forma este tipo de ligação. Por exemplo, através do cabeçalho 
Link. 

Vamos alterar a função Encurtador () para incluir este cabeçalho com 
o endereço das estatísticas da URL recém-criada. Precisamos modificar a cha- 
mada à função responderCom() da seguinte forma: 


func Encurtador() { 
PE go 


responderCom(w, http.StatusCreated, Headerst 
"Location": urlCurta, 
"Link": fmt.Sprintf("</s/api/stats/Js>; rel=\"stats\"", 
urlBase, url.Id), 


H» 


Agora podemos reiniciar o servidor e visualizar algumas estatísticas: 


$ go run servidor.go 


Vamos repetir o processo realizado anteriormente para criar uma nova 
URL curta, fazer algumas requisições a esta URL e, então, visualizar suas es- 
tatísticas: 


$ curl -v "http://localhost :8888/api/encurtar" \ 

-d "http://casadocodigo.com.br/products/livro-devops" 
POST /api/encurtar HTTP/1.1 

User-Agent: curl/7.30.0 

Host: localhost :8888 

Accept: */* 

Content-Length: 48 

Content-Type: application/x-www-form-urlencoded 


VM Mv Mv 
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HTTP/1.1 201 Created 

Link: <http://localhost:8888/api/stats/Cp+Hf>; rel="stats" 
Location: http://localhost :8888/r/Cp+Hf 

Date: Sun, 08 Jun 2014 22:08:24 GMT 

Content-Length: 0 

Content-Type: text/plain; charset=utf-8 


NA A A A A A R 


Repare que retornamos o cabeçalho Link com o endereço para acessar as 
estatísticas da URL recém-criada. Requisitando esta URL, teremos o seguinte 
resultado (mais uma vez formatado para facilitar a visualização): 


$ curl http://localhost :8888/api/stats/Cp+Hf 
{ 
aa Ai i 
"n id" : "Cp+Hf " r 
"criacao":"2014-06-09T00:08:24.899606706+02:00", 
"destino": 
"http://casadocodigo.com.br/products/livro-devops" 
+ , 


"clicks":0 


Nenhum acesso foi registrado por enquanto. Vamos fazer algumas requi- 
sições para a URL curta: 


$ curl http://localhost :8888/r/Cp+Hf 
$ curl http://localhost :8888/r/Cp+Hf 
$ curl http://localhost :8888/r/Cp+Hf 
$ curl http://localhost :8888/r/Cp+Hf 


Agora, se acessarmos novamente as estatísticas desta URL, veremos a se- 
guinte resposta: 


$ curl http://localhost :8888/api/stats/Cp+Hf 
{ 
MELSE 
"id":"Cp+Hf", 
"criacao":"2014-06-09T00:08:24.899606706+02:00", 
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"destino": 
"http://casadocodigo.com.br/products/livro-devops" 


+, 
"clicks":4 


Registramos corretamente os 4 acessos. Nossa API está finalmente com- 
pleta! 

Um detalhe importante é que, como requisições de redirecionamento po- 
dem ser (e normalmente são) armazenadas em cache, acessar as URLs curtas 
em um navegador pode produzir resultados diferentes na contagem de aces- 
sos. 

No próximo capítulo, veremos como melhorar o código produzido até 
aqui. 
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Refatorando o código 


Depois de implementar todas as funcionalidades no nosso servidor de URLs 
curtas, podemos analisar um pouco o código produzido e identificar alguns 
pontos de melhoria, como por exemplo: 


e Substituir variáveis globais onde possível; 
e Reduzir duplicação de código; 
* Introduzir logs; 


* Tornar a inicialização mais flexível. 


Vamos abordar cada um dos itens desta lista de forma separada. 
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1.1 SUBSTITUINDO VARIÁVEIS GLOBAIS 


Utilizar variáveis globais é uma forma muito prática de compartilhar recursos 
entre diferentes funções, objetos e métodos em um programa. No entanto, 
alguns destes valores podem ser bastante sensíveis, e permitir acesso global a 
eles pode introduzir uma série de problemas. 

Nosso servidor define três variáveis globais: porta, urlBase e o ca- 
nal stats. As variáveis porta e urlBase poderiam ser tratadas como 
constantes, pois são atribuídas durante a inicialização do programa e não so- 
frem alterações durante sua execução. Porém, em Go, não é possível declarar 
uma constante sem inicializá-la imediatamente, e um dos pontos de melho- 
ria é tornar a inicialização do servidor mais flexível, recebendo a porta como 
argumento, por exemplo. Isto impede que a variável porta seja uma cons- 
tante e, como a variável urlBase depende do valor definido para porta, 
ela também não pode ser uma constante. 

Por outro lado, o canal stats foi declarado como global apenas por 
conveniência. Atualmente, ele já é passado como argumento para a fun- 
ção registrarEstatisticas (),o que nos deixa com apenas um ponto 
de mudança: precisamos injetá-lo de alguma forma no contexto da função 
Redirecionador (). 

Como esta função é utilizada para atender requisições HTTP e registrada 
através da função http. HandleFunc (), ela deve obrigatoriamente seguir 
a assinatura definida pelo tipo http. HandlerFunc. Isso impede que adi- 
cionemos qualquer novo argumento a esta função. 

No entanto, o pacote http fornece uma outra forma para registrar han- 
dlers: a função http. Handle (). Esta função possui a seguinte assinatura: 


func Handle(pattern string, handler Handler) 


Veja que o segundo argumento é do tipo http.Handler, e não mais 
http.HandlerFunc. Este tipo é uma interface que define apenas um mé- 
todo: 


type Handler interface { 
ServeHTTP(ResponseWriter, *Request) 
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Podemos então criar um novo tipo que implemente o mé- 
todo ServeHTTP() e, desta forma, registrá-lo através da função 
http.Handle (). Vamos introduzir o tipo Redirecionador ao ar- 
quivo servidor.go como uma struct vazia: 


type Redirecionador struct{} 


Agora vamos alterar a função Redirecionador para torná-la compa- 
tível com o tipo http.Handler. Para isso, precisamos defini-la como um 
método no tipo Redirecionador (i.e. definir o tipo *Redirecionador 
como receptor do método), e também a renomear para ServeHTTP. O corpo 
da função deve permanecer inalterado: 


func (red *Redirecionador) ServeHTTP( 
w http.Responselriter, 
r *http.Request, 

)1 
PA is ae 


Por fim, precisamos alterar a função main() para registrar o tipo 
Redirecionador. Vamos alterar a linha que registra a rota /r/ da seguinte 
forma: 


func main() { 


dr temia 
http.Handle("/r/", &Redirecionador(J) 


PE sa 


Na prática, essas alterações não afetam o funcionamento do servidor. 
Reinicie-o e faça algumas requisições para ter certeza de que tudo continua 
funcionando. 

Esta nova estrutura, porém, permite que nos livremos facilmente do canal 
como variável global. Primeiro, vamos introduzir um campo na struct 
Redirecionador para armazenar o canal: 
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type Redirecionador struct 1 
stats chan string 


k 


Agora podemos remover a declaração do canal global stats. 

Como este canal é criado na função main (), exatamente o mesmo local 
onde registramos o tipo Redirecionador para atender requisições, pode- 
mos injetá-lo no momento da criação do objeto do tipo Redirecionador. 
Também precisamos alterar a criação do canal para declará-lo como uma va- 
riável local à função main (): 


func main() { 
stats := make(chan string) 


df mens 
http.Handle("/r/", &Redirecionador(stats)) 


Bh" oia 


Por fim, precisamos alterar o método ServeHTTP () para acessar o canal 
através do objeto receptor: 


func (red *Redirecionador) ServeHTTP( 
w http.ResponseWriter, 
r *http.Request, 


PR 

LP as 

if url := url.Buscar(id); url != nil { 
http.Redirect(w, r, url.Destino, 

http. StatusMovedPermanently) 

red.stats <- id 

+ else { 

dp” ota 
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Repare que, ao enviar o identificador da URL para o canal, agora utili- 
zamos a forma red.stats <- id, acessando o canal através do receptor 
red. 

Livramo-nos da variável global! 

Nosso próximo desafio é reduzir a duplicação de código. 


11.2 REDUZINDO A DUPLICAÇÃO DE CÓDIGO 


Quando introduzimos a função Visualizador () para retornar as estatís- 
ticas em formato JSON, acabamos com alguns trechos de código duplicados 
entre esta nova função e a função ServeHTTP do tipo Redirecionador. 

Analisando as duas com cuidado, encontramos um padrão comum: am- 
bas extraem o identificador recebido no caminho da requisição e buscam por 
uma URL correspondente àquele identificador; caso a URL seja encontrada, 
alguma ação é executada baseada no objeto url retornado; caso contrário, 
um erro HTTP 404 é devolvido. 

Podemos extrair uma função que abstrai toda esta lógica e, caso a URL 
buscada seja encontrada, executa uma função passando o objeto retornado 
como argumento. Vamos chamá-la de buscarUrlEExecutar (): 


func buscarUrlEExecutar ( 
w http.ResponseWriter, 
r *http.Request, 
executor func(*url.Url), 


J£ 
caminho := strings.Split(r.URL.Path, "/") 
id := caminho [len(caminho)-1] 
if url := url.Buscar(id); url != nil 1 
executor (url) 
+ else 1 
http.NotFound(w, r) 
$ 
+ 


Repare que esta função implementa exatamente a mesma lógica descrita 
anteriormente. O terceiro argumento recebido é uma função denominada 
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executor, que recebe um ponteiro para um valor do tipo url.Url (i.e. 
o valor retornado pela função url.Buscar ()). Esta função será chamada 
caso a URL seja encontrada. 


Vamos agora alterar o método ServeHTTP() do tipo 
Redirecionador para utilizar esta nova função: 


func (red *Redirecionador) ServeHTTP( 
w http.ResponseWriter, 
r *http.Request, 
E 
buscarUrlEExecutar(w, r, func(url *url.Url) { 
http.Redirect(w, r, url.Destino, 
http. StatusMovedPermanently) 
red.stats <- url. Id 


9) 


Por fim, vamos alterar também a função Visualizador, de maneira 
similar: 


func Visualizador(w http.ResponseWriter, r *http.Request) 1 
buscarUrlEExecutar(w, r, func(url *url.Url) { 
json, err := json.Marshal (url.Stats()) 


if err != nil { 
w.WriteHeader (http. StatusInternalServerError) 
return 

$ 


responderComJSON(w, string(json)) 


9) 


O resultado final é um código mais focado e melhor fatorado, permitindo 
que alterações na maneira como recebemos o identificador da URL, ou até 
mesmo na forma como retornamos erros HTTP 404, sejam feitas em um 
único lugar. 
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11.3 ESCREVENDO LOGS 


Escrever logs para cada ação realizada por uma aplicação é um recurso extre- 
mamente importante para identificar problemas ou mesmo rastrear requisi- 
ções. 

Go fornece alguns recursos simples para manipulação de logs no pacote 
log. 

Antes de mais nada, precisamos adicionar o pacote log à lista de depen- 
dências do nosso pacote main: 


import ( 
PR tás 
"log" 
RE as 
) 


Para facilitar, vamos criar uma função utilitária no arquivo 
servidor.go para nos ajudar a logar algumas ações: 


func logar(formato string, valores ...interface()) { 
log.Printf (fmt.Sprintf("Jsin", formato), valores...) 
} 


Todas as mensagens impressas através das funções do pacote log se- 
rão precedidas pela data e hora na qual foram escritas. Vamos introduzir al- 
gumas chamadas a funções desse pacote ao nosso servidor, começando pela 
main (): 


func main() { 


NE sta 
logar("Iniciando servidor na porta %d...", *porta) 


log.Fatal(http.ListenAndServe( 
fmt .Sprintf(":%d", *porta), nil)) 


Primeiro chamamos a função logar () para escrever uma mensagem 
indicando a porta na qual o servidor aguardará por conexões. 
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A função http.ListenAndserve () bloqueia a execução quando é ca- 
paz de iniciar o servidor com sucesso. Em caso de erro, no entanto, ela retorna 
um error que estávamos ignorando até agora. Envolvê-la em uma cha- 
mada à log.Fatal() é importante por dois motivos: primeiro, caso um 
erro ocorra ao iniciar o servidor, saberemos exatamente qual foi a causa do 
erro; segundo, a função log.Fatal() imprime uma entrada no log con- 
tendo a data e hora atuais e a mensagem de erro especificada (neste caso, o 
erro ocorrido ao iniciar o servidor), e imediatamente encerra a execução do 
programa retornando um código de erro para o sistema operacional. 

Por exemplo, caso um outro processo servidor já tenha sido iniciado na 
porta 8888, se tentarmos iniciá-lo novamente, veremos o seguinte erro no log: 


$ go run servidor.go 

2014/06/09 15:50:50 Iniciando servidor na porta 8888... 
2014/06/09 15:50:50 listen tcp :8888: bind: address already in 
use 

exit status 1 


Vamos agora adicionar uma mensagem de log quando uma nova URL 
curta é criada. Para isso, vamos incluir a seguinte chamada ao final da função 
Encurtador (): 


func Encurtador (w http.ResponseWriter, r *http.Request) { 
BM vãs 


logar ("URL %s encurtada com sucesso para %s.", 
url.Destino, urlCurta) 


A partir de agora, quando encurtarmos uma URL, veremos uma nova 
entrada no log, similar a esta: 


2014/06/09 15:56:43 URL 
http://casadocodigo.com.br/products/livro-ruby 
encurtada com sucesso para http://localhost :8888/r/rsHj_. 


Finalmente, quando registramos um acesso a uma determinada URL, 
na função registrarEstatisticas() fazemos uma chamada à 
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fmt.Printf() que pode ser substituída por uma chamada à função 
logar (): 
func registrarEstatisticas(ids <-chan string) { 
for id := range ids { 
url.RegistrarClick(id) 


logar("Click registrado com sucesso para %s.", id) 


Desta forma, quando registrarmos um acesso, a mensagem logada in- 
cluirá também a data e hora de quando o acesso ocorreu: 


2014/06/09 16:08:43 Click registrado com sucesso para rsHj.. 


Nosso servidor agora imprime mensagens de log para cada ação impor- 
tante executada. 


1.4 FLEXIBILIZANDO A INICIALIZAÇÃO DO SERVIDOR 


Para tornar nosso servidor mais flexível, é importante que algumas configura- 
ções possam ser modificadas sem que o código precise ser alterado. Por exem- 
plo, o número da porta onde o servidor aceitará conexões. Além disso, agora 
que introduzimos logs, podemos também incluir uma configuração para ligar 
ou desligar a geração de logs. 

Existem diversas formas de atingir este objetivo, como o uso de variáveis 
de ambiente, arquivos de configuração externos ou argumentos de linha de 
comando. 

Já vimos como receber e tratar argumentos de linha de comando anterior- 
mente através do pacote os. No entanto, existe um outro pacote que fornece 
recursos que facilitam o tratamento destes argumentos: o pacote flag. 

Para utilizá-lo, precisamos adicioná-lo à lista de dependências: 


import ( 
PE Gsh 
"flag' 
DM véus 
) 
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O pacote flag provê uma série de funções utilitárias para tratar as opções 
de linha de comando. Por exemplo, para definir uma opção -p que receberá 
o número da porta, podemos utilizar o código a seguir: 


porta := flag.Int("p,", 8888, "porta") 


Desta forma, definimos uma opção -p que deve ser um número inteiro. 
Caso nenhum valor seja especificado, o valor 8888 será usado. O último ar- 
gumento define o nome da opção, e será utilizado para gerar uma mensagem 
de ajuda. Veremos um exemplo em breve. 

Um detalhe importante é que as funções utilitárias do pacote flag para 
definir opções retornam ponteiros. Portanto, para transformarmos nossa va- 
riável global porta em uma flag, precisamos alterar seu tipo para *int. 
Vamos aproveitar e criar uma nova variável que irá definir se a geração de logs 
deverá ser ligada ou desligada: 


var ( 
porta *int 
logLigado *bool 
urlBase string 


Em seguida, vamos alterar a função init () para configurar as opções: 


func init() { 
porta = flag. Int("p", 8888, "porta") 
logLigado = flag.Bool("1l", true, "log ligado/desligado") 


flag.Parse() 


urlBase = fmt.Sprintf("http://localhost:Yd", *porta) 


Repare que incluímos uma chamada à função flag.Parse (). Ela efeti- 
vamente lê os argumentos recebidos na inicialização do programa e os valida 
de acordo com as opções definidas antes da chamada à flag.Parse(). É 
importante notar também que, de agora em diante, quando precisarmos dos 
valores reais armazenados nas variáveis porta e logLigado, precisamos 
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utilizar o operador de indireção, pois elas são ponteiros. Por este motivo, ao 
configurar a urlBase, usamos «porta como o número da porta. 

Se iniciarmos o servidor especificando a opção —h, veremos a mensagem 
de ajuda gerada pelo pacote flag: 


$ go build 

$ ./encurtador -h 

Usage of ./encurtador: 
-l=true: log ligado/desligado 
-p=8888: porta 


Agora, se tentarmos especificar uma porta inválida, veremos o seguinte 
erro: 


$ ./encurtador -p=abcd 

invalid value "abcd" for flag -p: strconv.ParseInt: 
parsing "abcd": invalid syntax 

Usage of ./encurtador: 

-l=true: log ligado/desligado 

-p=8888: porta 


Antes de continuarmos, precisamos garantir que aplicamos o operador de 
indireção em todos os lugares onde a variável porta é utilizada. Precisamos 
alterar as duas últimas linhas da função main () da seguinte forma: 


func main() { 


PR ta du 


logar ("Iniciando servidor na porta Yd...", *porta) 
log.Fatal (http.ListenAndServe( 
fmt.Sprintf(":Yd", *porta), nil)) 


Por fim, vamos alterar a função logar () para escrever as mensagens 
apenas se a opção -1 foi configurada com valor true: 


func logar(formato string, valores ...interface()) { 
if *logLigado 1 
log.Printf(fmt.Sprintf("Jsin", formato), valores...) 
} 
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Inicie o servidor com a opção -1=false e repare que nenhuma men- 
sagem de log será gerada. De maneira similar, especifique diferentes portas 
através da opção -p e veja se tudo continua funcionando. 

Nosso servidor de URLs curtas está finalmente completo! 
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Próximos passos 


Go é uma linguagem moderna, criada com o objetivo principal de melhorar 
a produtividade no desenvolvimento em larga escala de servidores, baseado 
nas experiências de alguns times dentro do Google. 

Hoje, mais de quatro anos após ter sido anunciada publicamente, cada 
vez mais empresas têm adotado a linguagem para escrever diversos tipos di- 
ferentes de aplicações, muito além dos servidores. 

Enquanto o conteúdo apresentado neste livro cobre algumas de suas 
funcionalidades básicas, incluindo partes importantes da biblioteca padrão, 
ainda há muito a ser aprendido. 

Para discutir sobre o conteúdo e os exemplos deste livro, participe 
da lista de discussão disponível em https://groups.google.com/d/forum/ 
casadocodigo-go. 

Além disso, todos os exemplos podem ser encontrados no GitHub, basta 
acessar https://github.com/caiofilipini/casadocodigo-go. 


12.1. Aprendendo mais Casa do Código 


O projeto do encurtador de URLs desenvolvido nos capítulos finais tam- 
bém está disponível em https://github.com/caiofilipini/encurtador. 
12.1 APRENDENDO MAIS 


Para continuar aprendendo sobre a linguagem Go, você encontrará a seguir 
alguns links selecionados (todos em inglês): 


Site oficial: http://golang.org/ 
Índice de pacotes da biblioteca padrão: http://golang.org/pkg/ 


Especificação da linguagem: http://golang.org/ref/spec 


Effective Go: http://golang.org/doc/effective go.html 


Blog oficial, contendo diversos artigos interessantes: http://blog. 
golang.org/ 


Índice geral da documentação oficial: http://golang.org/doc/ 
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